Installing and Updating Additional Core 
Enhancements (ACE) for HP-UX 10.20 

HP 9000 WDrkstations 


m 


HEWLETT® 

PACKARD 


B 3782-90658 
J une 1998 

©Copyright 1998 Hewlett-Packard Company 



Notices 


Use of this manual and compact disc(s), flexible disc(s) or tape 
cartridge(s) supplied for this pack is restricted to this product only. 
Additional copies of the programs can be made for security and back-up 
purposes only Resale of the programs in their present form or with 
alterations, is expressly prohibited. 

This document contains information which is protected by copyright. All 
rights are reserved. Reproduction, adaptation, or translation without 
prior written permission is prohibited, except as allowed under the 
copyright laws. 

Corporate Offices: 

Hewlett-Packard Co. 

3000 Hanover St. 

Palo Alto, CA 94304 

The information contained in thisdocument issubjectto change without 
notice. 

Hewlett-Packard makes no warranty of any kind with regard to this 
manual, including, but not limited to, theimplied warranties of 
merchantability and fitness for a particular purpose Hewlett-Packard 
shall not be liablefor errors contained herein or direct, indirect, special, 
incidental or consequential damages in connection with the furnishing, 
performance, or use of this material. 

A copy of the specific warranty terms appi icable to your H ewIett-Packard 
product and replacement parts can be obtained from your local Sales and 
Service Office. 

UNIX is a registered trademark in the United States and other 
countries, licensed exclusively through X/Open Company Limited. 

Copyright ©TheRegentsof the University of California 1979,1980, 
1983 

This software and documentation is based in part on the Fourth Berkeley 
Software Distribution under license from the Regents of the University 
of California. 

Copyright ©The Regents of the U ni versity of Colorado, a body corporate 
1979 

Copyright ©Veritas, I nc 1995. 


2 





This dcxument has been reprcxJuced and modified with the permission of 
the Regents of the U niversity of Colorado, a body corporate. 

Use, duplication or disclosure by the U.S. Government Department of 
Defense is subject to restrictions as set forth in paragraph (b)(3)(ii) of the 
Rights in Technical Data and Software clause in FAR 52.227-7013. 

Rights for non-DOD U.S. Government Departments and Agencies are as 
set forth in FAR 52.227-19(c)(l,2). 


Printing History 

June 1998 ... Edition 1. 

This edition documents material related to installing and upgrading 
FIP-UX operating systems and application software. Some of this 
material was previously included in I nstalling FIP-UX 10.20 and 
Updating from HP-UX lO.Oxto 10.20 (HP Part No. B2355-90119). 

The printing date and part number indicate the current edition. The 
printing date changes when a new edition is printed. (M inor corrections 
and updates which are incorporated at reprint do not cause the date to 
change.) The part number changes when extensive technical changes are 
incorporated. 

New editions of this manual will incorporate all material updated since 
the previous edition. 

HP Division: 

HP-UX Learning Products 
Hewlett-Packard Company 
3404 E ast H armony Road 
Fort Collins, CO 80528-9599 


3 





Customer Comments 

Please direct comments on documentation or software to the foil owing: 

user I i n k(gfc h p.com 

Fax: (970) 898-4720 

Hewlett-Packard Company 

WSY Information Engineering Group 

Mai I stop #27 

3404 East Harmony Road 

Fort Col I i ns, CO 80528-9599 


4 





Contents 


1. Before You Install 

Planning Your New I nstallation.10 

Media for the Release.10 

I nstallation Tasks.10 

What is a Cold I nstall?.11 

Supported Hardware.15 

Some ACE Features.16 

System Requirements.17 

Hardware Requirements.17 

Networking Requirements.19 

Checking the Media.20 

Using Software Bundles.20 

Obtaining and Entering Codewords.21 

Backing Up Your Current System.22 

Choosing the I nstall Source.24 

Setting Up the Network I nstall Source.24 

2. Installing HP-UX 

Booting from Media (All Series).28 

Workstation Boot Process.29 

After Selecting Boot Paths If you see the following question on your 
screen, typen:31 

Booting from a Network (Workstation/Series 700, B, C J ).32 

Older Workstations.32 

Newer Workstations.33 

System Configuration.35 

Installing and Configuring the Operating System.36 

Configuring for Network Installation.36 


5 


























Contents 


Selecting the R(X)t Disk.39 

Viewing or Modifying Configuration.41 

Configuring the Disk and File System.45 

Loadi ng the Core Operati ng System.51 

Specifying System I nformation.53 

Verifying and Completing the I nstallation.55 

Listing I nstalled Applications During Load.55 

Removing Unwanted Software/Filesets.56 

Creating a Recovery System.57 

I nstal ling Extension Software.57 

I nstal ling Applications Software.57 

3. Updating HP-UX 

FIP-UX 10.20 System Requirements.60 

Starting the Source Media.61 

U pdati ng SD-U X Before I nstal I i ng/U pdati ng Software.63 

SW-DIST Installation.64 

U pdati ng SD-U X Without Root Access to the Remote Depot.64 

Updating FIP-UX Software.67 

Updating a Single System or Server Cluster.67 

Updating a Cluster.67 

Updating Non-I nteractively from Media or Network.75 

Using FIP-UX Extension Software.75 

Adding Additional Functionality.76 

Networking Products on Additional Media.77 

Installing the Optional Online] FS Product.77 

4. Troubleshooting Your Installation 

Network I nstal I .80 


6 





























Contents 


Media I nstall.81 

Adjusting File System Size.81 

Large System.84 

A. Sample Configuration File 

B. Configuring for a DHCP Server 

Using DHCP Services: Overview.92 

Setting Up a DHCP Server.93 


7 








Contents 


8 




Before You Install 


This manual covers HP-UX 10.20, Additional Core Enhancements (ACE) 
"cold" installations and updates, as well as updates from 10.x to 10.20. 

• Coldinstall means installing system software on a new (uninstalled) 
or existing system disk in such a way as to completely erase old data. 
See Chapter 2, "I nstalling HP-UX," for the cold install procedure for 
HP-UX 10.20. 

• Update, for H P-UX 10.x, means using the SD-UX tools to install new 
OS or application softwarefrom a media or network source depot. See 
Chapter 3, "U pdati ng H P-U X," for the procedure for 10.x to 10.20 core 
OS updates and for updating related software. Usethetool swiist 
with your install depot to obtain current information on bundle and 
product contents. 

• Upgrade means using the 9.U3 tools and procedures to update your 
system from a pre-10.0 version of H P-UX to 10.01. The SD-UX tools 
are then used to update from 10.01 to 10.10 or 10.20.1 nformation 
about utilities and procedures for upgrading your system from 
HP-UX 9. Ox systems is covered in the manual Upgrading from 

H P-UX 9.x to 10.x and in the Release Notes for this software (online in 

/us r/share/doc). 
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Before You Install 

Planning Your New Installation 


Planning Your New Installation 

New features, component software, and recent changes for your new 
workstation are described in the Release Notes for this release, located in 

/usr/share/doc. 

For a listing of patches, and the current Known Problems, see the Read 
Bd'ore I nstal I i ng for this release. 

Media for the Release 

The following CDs are supplied with typical Media Kits, for 
Workstations as indicated: 

• UsethefollowingtwoCDstoinstall theACE software 

• Install and Core OS Software: Plus Additional Core 
Enhancements. 

• HP-UX Diagnostic/I PR Media. This contains the Quality Pack 
Bundle (Critical Patches). 

• HP-UX Recovery Media. 

• 10.x Extension Software. 

• H P-UX Application Software (5 CDs). 

• I nterworks Contributed Software (2 CDs). 

Installation Tasks 

During the H P-UX 10.20 installation process, you will need to do the 
following: 

• Connect and test devices. 

• Boot a minimal operating system from media (or a network). 

• Install software products from CD-ROM, or network. 

• Execute HP-UX commands. 

Some of these tasks may require previous experience or the availability 
of a system administrator. 
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Before You Install 

Planning Your New Installation 


Before you begin the install process, you should be prepared to enter 
some information as part of the process (especially if you are installing 
any part of the OS and applications from a network source). The process 
may ask for such information as the following: 

• The hostname of the (new) system on which you are installing 
HP-UX. 

• The local host's I nternet Protocol (I P) address. 

• Default routing I nternet Protocol (I P) address. 

• The subnet mask (for example, 255.255.248. o or Oxf f f f f 800). 

• The IP address of an install server (if used). 

If you have a DHCP server available, the network information can be 
provided automatically. See Appendix B, "Configuring for a DHCP 
Server." 

After you have installed the 10.20 operating system, you will use other 
HP-UX tools, utilities and scripts to set up windowing, networking, 
printing, mail, etc. This document does not cover these post-installation 
activities. For further information on these tasks, seethe manual System 
Administration Tasks (HP Part No. B2355-90079). 

What is a Cold I nstall? 

A cold install is performed when your new system does not come with a 
pre-loaded operating system, or when a system is corrupted and you 
want to start over with a new H P-UX 10.x system. 

If you purchased your system with the HP-UX I nstant Ignition option, a 
version of H P-UX has already been installed, according to the 
specification in your order. You do not need to reinstall it unless you want 
to makechanges in thedisk layout. 

The Installation Process 

This HP-UX installation procedure is similar tothat used for previous 
versions of H P-UX 10.x. During the cold install process, an install kernel 
is booted from the HP-UX I nstall Media (see below) or from a server on 
the network (Workstation (Series 700) only). Your system disk is then 
initialized and the new system configured using a set of default 
configurations supplied on the I nstall Media. You can either use one of 
these default configurations or create your own custom configuration. 
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Before You Install 

Planning Your New Installation 


Once the configuration and initialization is complete, a new 
full-functioned HP-UX operating system and applications are loaded 
from the H P-UX 10.20 media (or from the network) onto your system 
disk. 


CAUTION A cold install will erase all existing data on the target disk(s) during the 

process. 


The HP-UX 10.20cold install process is similar for all current HP 9000 
computer platforms. See the flow chart Figure 1-1 which outlines the 
process. 
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Before You Install 

Planning Your New Installation 


Figure 1-1 


The Cold Install Process 



Each of thesteps in thediagram isexplained in Chapta 2. 
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Before You Install 

Planning Your New Installation 


The HP-UX 10.20 Install Media 

The I nstall program software is a single, self-contained volume on 
CD-ROM (combined with the HP-UX core) which contains the foil owing 
Install items: 


Lit File 

ISL 

HPUX 

AUTO 

CONFIG 

INSTALL 

INSTALLFS 

INSTCMDS 

SYSCMDS 


Purpose 

The initial system loader. 

A secondary loader. 

The auto-boot file. 

The file that describes the default system 
configurations which you can specify. 

The install kernel. 

Install RAM File System. 

A compressed tar-archive cental ni ng the commands 
used during the InstalI process In the RAM-FS. 

A compressed tar-archive containing the mini-system 
that is extracted prior to running the SD-UX software 
management commands. 


Seethe Read Before I nstal ling that came with your media kit for the list 
of patches and components on your install and Core CD and on the 
Diagnostic/I PR CD Quality Pack bundle. 


On H P 9000 Workstations (Series 700), the I nstall Kernel can also be 
loaded from a network source. See the section "Booting from a Network 
(Workstation/Series 700, B, C J )", in Chapter 2, "I nstal ling H P-UX,"for 
more information on network installations. 


The HP-UX Product Media 

The product media for the "Install and Core" HP-UX product consists of a 
CD-ROM containing both the I nstall program and the Core HP-UX 
product. The CD contain all the bundles, products and fiIesets, both 
required and optional, for a fully functional system. For this ACE 
release, you will also need to load the Quality Pack bundlefrom the 
Diagnostics/I PR disc. See "Some ACE Features"and "Using Software 
Bundles", in this chapter, for more information on the software. If you 


14 


Chapter 1 



Before You Install 

Planning Your New Installation 


Workstations 


Servers 


are using optional networking products on additional media, please see 
also "Networking Products on Additional Media", in Chapter 3, 

"Updating HP-UX,"in this manual. 

A display listing of 10.20 bundles, products, and contents can be obtained 
by running swiist on your source depot (disk, CD-ROM, tape, or 
network). See Chapter 3, "Updating HP-UX," for instructions on using 
swgettoois to update the SD-UX tools first, if the source is a new 
version of H P-UX. 

Supported Hardware 

The following new workstation hardware is supported on this release, at 
the time of printing. (See your HP representative for updated 
information): 

Model CPU Speed(MHz) 


B132L-F PA-7300LC 

132 

B180 

PA-7300LC 

180 

C200 

PA-8200 

200 

C240 

PA-8200 

236 

J 2240 

PA-8200 

236 


The following are supported for NFS diskless client-server 
configurations: 

Models 705, 710, 712, 715, 720, 725, 730, 735, 742, 743, 745, 747, 
748, 750, 755, B-class, C-classandJ -class 

Server systems supported on this release include the following: T600, 
K370, K570, K380, and K580. See your HP representative for updated 
support information. 
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Planning Your New Installation 


Some ACE Features 

Quality Pack The Quality Pack bundle, on the Diagnostics/I PR CD (and replicated on 

the Extension Software CD) that accompanies this ACE release, replaces 
the Critical Patch bundle for workstations that was previously 
distributed on the I PR media. The Quality Pack is a superset of the 
previous I PR Critical Patch bundle. It includes many core patches that, 
although not all marked as "critical," are nevertheless still required to 
run many third party applications on H P-UX 10.20 systems. You must 
load this Quality Pack in order to get supported configurations. 

The Quality Pack also includes a collection of patches that are required 
before the H P-UX 10.20 core can support Year 2000 compliant 
applications. The H P-UX "core" consists of the kernel, commands, and 
basic graphics run-time software, such asCDE, X server, Starbase, and 
HP PEXlib. Patches for HP-UX layered products - which are distributed 
on Application Release media - appear elsewhere. 

The J2240 Software The current ACE includes] 2240 PA-RI SC enablement software and 
other software for use with this and other new systems, originally 
released with the April 1998 ACE. 

TheJ 2240 software includes two ACE bundles for HP-UX.TheJ uly 1997 
Workstation ACE bundle added support to H P-UX for the PA-RI SC 8200 
processor. Ultra SCSI l/Q, 100BaseT networking, VISUALIZE-FX 
graphics, and the QpenGL 3-D programming API. The April 1998 ACE 
added multiprocessor (MP) configuration support for thej 2240. 


CAUTION Do not remove earlier Workstation ACE bundles from a J 2240 computer. 

This software is necessary to boot and run thej 2240. 


Upgrading to a J2240 For information on upgrading a J 282 system, see the instructions in 
Model] 2240Upgrade(P/N A2876-90012). 

For information on known problems, refer to the "Known Problems" 
section of the current Read Bd'ore I nstalling . 
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System R equ i rements 

Besides the mini mums shown below, you will have additional 
requirements for such things as swap space, tools, utilities, facilities, 
environments, applications, languages, user files, data, graphics, 
printing and plotting. Refer to the System Administration Tasks manual 
for information on these topics. 

Hardware Requirements 

To install this OS software, you must have the foil owing: 


Computer A supported H P 9000 Workstation, which includes 

Models 700, B, C andj. See "Supported Hardware", in 
this chapter, for a list of supported systems. 

Memory The minimum RAM for H P-UX 10.20 is 16 M B. Your 

HP representative can assist in obtaining the proper 
amount of RAM. I nformation on RAM requirements is 
also on the following web site: 

http://www.hp.com: 80 /computing/mvp/memory. 
html. 


Source Device Make sure that your system has an appropriate source 
(CD-ROM, DDS drive, or network (S700, B, C, or J )). 
For tape drives, be sure the heads are clean. 

Disk Drive At least one hard-disk drive with at least the following 
capacities: (The install program performs an analysis 
of disk space needed prior to loading the software.) 


• 525 MB for a minimum standalone workstation. 

• 1GB or more for a generally usable system. 

Other Devices Your system can also have any H P-supported device. I f 
you have an unsupported device connected to your 
system, HP assumes no responsibility in making that 
device fund ion properly. 
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Disk Layouts 


Before You Install 

System Requirements 

Supported Peripherals 

With the disk space provision above, ai i disk drives that are supported as 
HP Workstation and Server system disks are supported for instaiiation. 

Disk arrays can be instaiied with HP-UX, but the instaiiation tasks do 
not support configuring an array. See your array documentation for 
configuration information. 

The H P-UX instaiiation toois support VTIOO and Wyse 60 terminais, 
compatibieemuiations, and aii HP terminais. 

Supported File System Types and Layouts 

The HP-UX 10.20 fiie system iayout is quite different from HP-UX 9.0x 
reieases. The 10.20 fiie system is modeied after the UNiX™ SVR4 and 
OSF/1 systems. This iayout provides such benefits as the separation of 
OS software from appiication software, and it aiso resembies the UNiX 
standard iayout used by many other computer companies. 

HP-UX 10.20 supports thefoiiowing fiiesystem types: 

• UFS/HFS or VxFS (J ournaied Fiie System) on iocai disk voiumes. 

• NFS. 

The fiie system for a coid-instaiied H P-UX wiii be supported on the 
foiiowing disk iayouts: 

• "Whoiedisk" (si ngie fiie system, singieswap partition disk iayouts as 
on H P-UX 9.0 for Series 700). 

• The Logicai Voiume Manager (LVM). 

The Logicai Voiume Manager is offered on both the Series 700 and Series 
800 piatforms. Becauseit heips to organize fiiespace across muitipie 
physicai disks, you are encouraged to adopt this method of disk 
management. Seethe manuai System Administration Tasks, or the 
ivm(7) man page for detaiis. 

For H P-UX 10.20, Series 700 Software Disk Striping arrays are not 
supported. SDS arrays can be converted to LVM via the utiiity 
sdstoivm. ifyou upgrade to HP-UX 10.20, as opposed to instaiiing it, 
this conversion wiii be done for you automaticaiiy during the upgrade. 
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System Requirements 


LVM disk striping can beset up on somevolumesduring the installation. 
However, striped volumes cannot be mirrored later on. Note that not all 
types of volumes may striped. This is due to an unbalanced amount of 
disk space assigned to the root/boot/swap volumes on the root disk that 
must not be striped. 

Networking Requirements 

Networking capabilities are not mandatory for a 10.20 cold install unless 
you are loading your OS and applications from a remote system. If you 
are loading from a remote system, you will need the following (for the 
Ethernet™ interface): 

• A network card. If your system has multiple LAN cards, select the 
card that is configured onto the correct network during the install 
process. Only one card can be configured for install. All other cards 
will not be configured and cannot be used during the installation. 

• A network install server. This must be on the same network subnet as 
the system that will be booted. This may require having one server on 
each subnet from which to boot clients. 

• Afunctional network connection. If you have more than one LAN 
connection, be prepared to select the correct one with which to 
connect to the install server system. 

Note You cannot cold install via the network from a non-Ethernet 
i nterface 
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Checking the Media 


Checking the Media 

Make sure you have obtained the HP-UX tape or CD-ROM that matches 
your source device type. Note that applications requiring codewords will 
be on a separate CD. If your HP-UX product has multiple licenses, the 
installation process will install the most restrictive license unless you 
load a higher level license from the applications CD-ROM. 

Using Software Bundles 

The software "bundle" is a collection of filesets that have been 
encapsulated by H P for a specific purpose. These bundles make it easier 
to load several filesets onto your system as a single entity using the new 
SD-UX Software Distribution Commands (swinstaii, swcopy, 
swremove, etc). Bundles can be kept in SD-UX depots and copied, 
installed, removed, listed, configured and verified. All H P-UX 10.20 OS 
software is packaged in bundles to make it easier to install. See 
Managing HP-UX Software with SD-UX (H P Part Number B2355-90080) 
for more information on SD-UX commands, bundles and depots. 

A bundle is used in the same way as the pre-10.20 "partition", except 
that a bundle can contain filesets from several different products. I n 
general, performing a single operation on a bundle is the same as 
performing it individually on all the filesets listed in the bundle. 

Bundles do not eliminate your ability to choose which initial products 
and filesets you wish to load on your system. You may still do this by 
i nteracti ng with the swinstai i uti I ity (see "Loadi ng the Core Operati ng 
System", in Chapter 2, "I nstalling H P-UX.") 
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Obtaining and Entering Codewords 

There are two types of software on the Product Media: protected and 
unprotected. The core H P-UX software is not protected and has no 
codeword. To access any protected software on a CD-ROM, you must 
enter an authorized codeword in the SD interface. To access unprotected 
software, no codeword is required (for example, the HP-UX 10.20 
Runtime bundle does not require a codeword). 

You will haveaccessonly to those items on the CD-ROM medium that 
you have purchased, which are unprotected, or for which you have the 
proper codeword. Your codeword appears on the document Codeword for 
I nstalling Softwarethat comes with your software; it is associated with 
your customer ID. If you received a document Codeword for I nstalling 
Software— Submittal Certificate along with a Codeword Request Form, 
you can obtain a codeword and Customer ID by returning the latter form 
to the HP License Administration. 

Product Examine all the packages that contain your products and the Software 

Documentation Certificate(s). Keep the certificates handy. I f your certificate does not 

include a codeword (and you want to load optional, protected software) 
you must obtain a codeword from Hewlett-Packard by following the 
codeword instructions that come with your Software Certificate. If you 
have problems with the codeword process, contact H P License 
Administration. 
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Backing Up Your Current System 

• If you currently have no operating system or files on your system or if 
you have an OS and software that you can safely destroy, there is no 
need to perform a backup. You can now proceed with the installation 
and later set up a backup procedure. 

• If you already have an operating system and files on the system disk, 
you should make a full backup of the system before you start the 
install. 

If your system is running a 9.0x version of H P-UX, you may want to 
upgradeto H P-UX 10.20 (via 10.01), not install it. Seethe manual 
Upgrading from HP-UX 9.xto 10.xfor detailed procedures for 
performing an upgrade. 

• You must be running 9.0 or later to upgradeto 10.20. 

• If you have a system running a pre-9. Ox version of HP-UX, and you 
are willing to destroy all system customization in order to install 
10.20, then cold-installing 10.20 may be the right answer. 

Remember that HP-UX 10.20 uses pathnames and file locations that 
are different from H P-UX 9.0x. Back up your current system, if any, 
in such a way as to separate "structural" (system) directories from 
"data" (user and application) directories. This will allow you to 
recover data directories onto 10.20 without compromising the 10.20 
structure. 

You should not recover any pre-10.0 "structural" files onto the 10.20 
system. Recover them only if the 10.20 install faiisfor some reason and 
you need to restore the pre-10.0 version of H P-UX. 

For additional backup security for cold install, you can optionally do the 
following: 

• Make printouts of customized files and refer tothem after the 
installation (for example, files such as .profile, /etc/netiinkrc, 
/etc/passwd). 

• Collect customized files in a directory (for example, /old). Use 
tar (1) to make a tape archive of the files in /old. After the 
installation, restore the files, editing them as desired. 


22 


Chapter 1 







Before You Install 

Backing Up Your Current System 


You should also make copies of your "dot" files (for example, .profile 
and .maiirc). For further information about these files, seethe manual. 
System Administration Tasks. 
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Choosing the Install Source 

An HP-UX 10.20 cold install can be made from two different sources. 

• Physical media (CD-ROM). See "Booting from Media (All Series)", in 
Chapter 2, "I nstalling H P-UX." 

• Network source. See the next section, "Setting Up the Network 
Install Source". 

You can also choose to load only the I nstall Kernel from the installation 
media and then load the Core OS bundles and products from a network 
source. 

Setting Up the Network I nstall Source 

A "network cold install" uses another machine on the network as its 
installation source. Once this isset up, a network install isthe fastest 
installation method. Complete network cold installscan bepaformed on 
a Series 700 (including B, C, and J ) Workstation system only, but you can 
use either a Workstation or a Server (Series 800) system as the install 
server. After an install server is set up on your network, you can boot 
new systems from the server, and once booted, the I nstal lation process is 
similar to installing from physical media. 

Requirements for a network install server are: 

1. HP-UX 10.20 on the server system. See "H ardware Requi rements", i n 
this chapter. 

2. Your server must be on the same network subnet as the system that 
will be booted. This may require having one server on each subnet 
from which to boot clients. 

3. You must have the HPUX-instaii product or Netinstaii bundle 
loaded on the server. If Hpux-instaii is not installed on your server, 
you must load it from the 10.20 Cor e-OS media using the swinstaii 
command. You can obtain the Hpux-instaii product by loading the 
entire Netinstaii bundle from the Core-OS media. 

4. You will need about 21 MB of free space in the server /usr/iib 
directory to accommodate hpux-install. 
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5. You must edit the file /etc/insti_boottab on the server and add 
at least one IP address that is reserved for booting install dients. The 
IP addresses you add should be for cold installs only and should not 
be used by any other systems. However, if you know the LAN Link 
Addresses (L L A) of the systems you wi 11 be i nstal I i ng, you can use the 
IP addresses of those systems, providing you append the keyword 
"reserve". See the examples in the file /etc/insti_boottab for 
more guidance. 

6. If you want to boot multi pie systems from the server at the same 
time, you must add more than one IP address to this file. The server 
may deny boot services if multiple systems try to use the same IP 
address during booting. 

Optional Install Server Configuration Steps 

After your install server is set up, you may want to create some default 
parameters to makethe process easier. Running the insti_adm 
command on the server can do this. 

For example: 

Use insti_adm (iM) toset the default SD-UX server and depot as in the 
following command line (where sd_serva is replaced by the hostname of 
theswinstall server, and /var/hpux_depot is the location of its software 
depot): 

insti_adm -s sd_server :/var /hpux_depot 

You can also create a message that can be displayed to users during the 
installation. 

For example: 

The i nsti_adnn —a option can be given a filename that contains the 

message or, if given a " (dash) as shown below, the command will 
prompt you to type in the message foil owed by ctri-D "end-of-file". Adding 
the -d option will cause the command to display the default information 
after making the changes, as follows: 

instl_adm -a - -d 

The insti_adm (iM) Utility can also allow the advanced user toset up 
enough information tocompletely automate the installation. This is done 
by specifying configuration information as listed in the instl_adm(4) man 
page. Appendix A inthis manual gives an example of a configuration file. 
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Before You Install 

Choosing the Install Source 

For More Information 

For a listing of patches, and the current Known Problems, see the Read 
Bd'ore I nstal I i ng for this release. 

For examples of install configuration files, see Appendix A, "Sample 
Configuration File,", in this manual. 

For general information, see the online information on the install 
program in /usr/share/doc/lO . 2 0ReiNotes. For more details on 
setting up a network server, see the comments in the 
/etc/insti_boottab file, and the instl_bootd(lM) man page 

If you have problems in booting systems, look in the file 
/var/adm/sysiog/sysiog. log for error messages which will tell you 
whether more IP addresses are needed. 

For more details on depots and the swinstaii command, seethe 
manual Managing FIP-UX Software with SD-UX. 


Information on HP 
Software Deport 


Seethe FIP Information website, www.hp.com (Business and Technical 
Computing: Documentation) for additional FIP-UX documentation. 
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Installing HP-UX 


I n this chapter you will find start-up procedures based on the use of two 
types of sources: 

• Booting from media. 

• Booting from a network (Series 700, B, C and J classonly). 

If you have any problems, see Chapter 4, 'Troubleshooting Your 
I nstallation,". 
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CD-ROMs Used in 
Installation: 


Procedure 


Installing HP-UX 

Booting from Media (All Series) 


Booting from Media (All Series) 

Both thGInstall and CORE OS Software Plus Additional Core 
Enhancements CD and theDiagnostic/IPR Media CD will bGnGOded 
for a fully supported installation. The following is a list of CDs in a 
typical media kit: 

• HP-UX 10.20 Install and CORE Plus Additional Core 
Enhancements. This istheOS media. Use this and the 
Diagnostic/iPR discfor the ACE installation. 

• Diagnostic/iPR Media. This CD is requi red for the Quality Pack 
bundle Owhich it contains. 

• HP-UX Application Software. (5 CDs). 

• HP-UX Recovery Media. 

• HP-UX Extension Software (I ncludes essential patches). 


1. Check with your system administrator, if necessary, about the 
hardware path and identity of your boot CD-ROM. 

2. M ake sure any external boot device connected to the system to be 
booted is turned on. 

3. Turn on the computer or cycle power. 

4. P ress esc to stop the boot process. 

5. I nsert the install media into the appropriate drive. 

• Workstations: At the message that says how to stop autoboot, 
press and hold esc. 

• Servers: At the message that says how to stop autoboot, press and 
hold any key. 

You will seethe boot console menu. As boot procedures vary 
somewhat, depending on your hardware, the following pages give you 
detailed guidance on various types of systems. 
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Booting from Media (Aii Series) 


After it does a search, the boot ROM lists the devices from which you can 
boot. If a desired local boot device is not listed, and you have connected 
and powered it, check the cable connections before proceeding. LAN 
sources may require several searches. 

I n either a Server or a Workstation boot console, there is an on-line help 
facility to guide you through the process. If you need help, type help 
boot. 

Workstation Boot Process 

If you stop the boot process, the system will display a menu of boot 
commands. For some systems, you will see a help display similar to the 
following: 

For different computers, depending on your hardware type, you may see 
slightly different screens in the autoboot process. 


Newer Workstation 
Boot Heip Menu: 

Figure 2-1 


Description 


Command 

Auto [boot I search] [on[off] 

Boot [priI alt Iscsi.addr] [isl] 

Boot Ian[.lan_addr] [install] [isl] 
Chassis [on|off] 

Diagnostic [on|off] 

Fastboot [on I off] 

Help 

Information 
LanAddress 
Monitor [type] 

Path [prilalt] [ Ian.id|SCSI.addr] 
Pirn [hpmcI toe IIpmc] 

Search [ipl] [scsi|Ian [install]] 
Secure [on|off] 


Display or set auto flag 

Boot from primary, alternate or SCSI 

Boot from LAN 

Enable chassis codes 

Enable/disable diagnostic boot mode 

Display or set fast boot flag 

Display the command menu 

Display system information 

Display LAN station addresses 

Select monitor type 

Change boot path 

Display PIM info 

Display potential boot devices 

Display or set security mode 


When you see this screen, do the foil owing: 

1. Type search Enter. 

2. If your CD-ROM device is identified in the list shown by the search 
command, proceed with the following steps. Otherwise, check the 
device and cable connections and repeat the search. 
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Installing HP-UX 

Booting from Media (Aii Series) 


3. Type the foil owing: 

boot scsi.X 

Use the SCSI address of the boot device for x. 

4. If you see the foil owing prompt, respond with "n". 

Interact with IPL (y or n)? 


Older Workstation Older Series 700 systems display a menu similar to the following: 
Boot Menu: 

Figure 2-2 

b) Boot from specified device 

s) Search for bootable devices 

a) Enter Boot Administration mode 

x) Exit and continue boot sequence 

?) Help 

Select from menu: 

When the actions menu shown above appears, do the foil owing: 

• Press s Enter, to Start a search for bootable devices. 

Older Workstation 
Search Results 

Figure 2-3 


Searching for Devices 

with 

Bootable 

Media. 


To terminate search. 

press 

and hold 

the ESCAPE 

key. 

Device Selection 

Device Path 


Device Type and Utilities 


PO 

scsi.6.0 

HP 

IPL 

2213A 

PI 

scsi.3.0 

HP 

IPL 

HP35480A 

P2 

scsi.0.0 

TOSHIBA 

IPL 

CD-ROM XM-3301TA 

Enter boot selection. 

(h)elp, or e(x)it: 





You will see a list of "pn" selections, as above. 

If the desired device does not appear in the search list, do the following: 
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Booting from Media (Aii Series) 


Time Note 


Time Note 


1. Check the hardware. 

2. Press X Enter. 

3. Types Enter to initiate another search. 

4. At the prompt "Enter boot selection", enter the "pn" device 
selection for the device containing your install media. 

I f you know the SCSI address of the boot device beforehand, you can ski p 
the search and simply type the following at the "Select from menu" 
prompt: 

b scsi.X 

After you have selected your boot device, loading the install kernel on a 
Workstation should take 3 to 5 minutes. After this you will be ready to 
interact with the rest of the H P-UX I nstall Utility to load the remainder 
of your system. 


After Selecting Boot Paths I f you see the fol lowi ng 
question on your screen, type n: 

Interact with IPL (Y or N)?> n 

5. You can abort the installation at this point, if you wish, by turning 
the system off and starting over. 

6. When you have chosen the boot path and loaded the I nstall Kernel, 
the system will display the H P-UX I nstallation Welcome screen. 
From this point on, you will respond to the requests for information 
on these screens. 

Loading the I nstall Kernel should take 3 to 5 minutes. 

For the remainder of the installation, goto "I nstalling and Configuring 
the Operating System", in this chapter. 
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Figure 2-4 


To Search for Servers: 


Installing HP-UX 

Booting from a Network (Workstation/Series 700, B, C J) 


Booting from a Network 
(Workstation/Series 700, B, C J ) 

1. Determine your network server address for the i nstalI. I f necessary, 
see your system administrator for this information. 

2. Turn on your Workstation. 

3. When you see a message about stopping the boot search, quickly 
press and hold esc to stop the boot selection process. 

Older Workstations 

On older Series 700 machines, you will eventually see the foil owing: (For 
newer Workstations, see the section "Newer Workstations", in this 
chapter.) 


b) Boot from specified device 

s) Search for bootable devices 

a) Enter Boot Administration mode 

x) Exit and continue boot sequence 

?) HelpSelect from menu: 

Do one of the fol lowi ng: 

• If your network has only one install server and your system is not 
configured as a diskless client, then type the fol lowing: 

boot Ian 

The boot may fail thefirsttimebecauseof an intentional delayed 
response by the I nstal I server. If it fails, try it again. If it fails more 
than three times, check for problems on the install server (see 
Chapter 4, 'Troubleshooting Your I nstallation,"). OR 

• If your network has multiple install servers, make sure you boot from 
the network server address specified by your system administrator. 

1. Type the fol I owing: 

search Ian Enter 

2. I f your I nstal I server does not appear duri ng the search, type "x" I n 
order to exit and continue the boot sequence. 
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Booting from a Network (Workstation/Series 700, B, C J) 


• If necessary, type the foil owing command again: 

search Ian 

Note that it will typically take two or three searches bd'orethe 
install server will befound, duetoa built-in delayed response from 
the install server. 

• Identify your LAN server from the listing. 

• I f three attempts result I n no response from the desi red server, see 
Chapter 4, 'Troubleshooting Your Installation." 

3. If you know the Ethernet™ address of your install server and can 
specify where to boot without goi ng through the search process, type: 

boot Ian. 080009-nnnnnn 

where 080009-nnnnnn is the Ethernet address of the install server. 
This number can befound by running the lanscan(lM) command on 
the server. 

• If your server is listed during the search, then you can boot the 
system by typing "p" and the index number of the server. For 
example: 

pi 

This will cause the boot to begin. OR 

• Alternatively, you can exit this screen by typing "x Enter", and typing 
"boot pi" at the previous screen. 

Newer Workstations 

On newer Workstations, after the power is turned on, you will see a 
graphical interface screen that displays instructions to press esc to stop 
the boot process. 

1. Press ESC, and you should see the foil owing menu: 


Figure 2-5 
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Booting from a Network (Workstation/Series 700, B, C J) 


Command 

Auto [boot I search] [on[off] 

Boot [priI alt Iscsi.addr] [isl] 

Boot Ian[.lan_addr] [install] [isl] 

Chassis [on|off] 

Diagnostic [on|off] 

Fastboot [on I off] 

Help 

Information 
LanAddress 
Monitor [type] 

Path [prilalt] [ Ian.id|SCSI.addr] 

Pirn [hpmcI toe IIpmc] 

Search [ipl] [scsi|Ian [install]] 

Secure [on|off] 

BOOT_ADMIN> 

• If your network only has one install server available, type the 
following: 

boot Ian install 

• Otherwise, to make sure you boot from the correct server, do one of 
the foil owing: 

• M ake the system search for servers and pick one. OR 

• Explicitly tell the system whereto boot, as follows: 

a. To search for servers type the following: 

search Ian install 

b. The list of servers will be displayed with IP addresses. You may 
need to run the command nsiookup on another runni ng system to 
determine which address corresponds to your server. 

c. Once you know the IP address of your server (as provided by the 
search, or by the nsiookup command), boot the system by typing 
the foil owing: 

boot Ian . nn.n.nn.n install 

For nn.n.nn.n, supply the network address of your server. 

The system then begins to load the install kernel from the 
network server. 

Time Note This should take 3 to 5 minutes. 


Description 

Display or set auto flag 

Boot from primary,alternate or SCSI 

Boot from LAN 

Enable chassis codes 

Enable/disable diagnostic boot mode 

Display or set fast boot flag 

Display the command menu 

Display system information 

Display LAN station addresses 

Select monitor type 

Change boot path 

Display PIM info 

Display potential boot device 

Display or set security mode 
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Booting from a Network (Workstation/Series 700, B, C J) 


System Configuration 

Whether you booted the install kernel from the media or from a network 

source, after your system is running it will analyze your new system for 

the following information: 

1. The install kernel location and (disk) device identities connected. 

2. Console tty settings, keyboard language (itemap) and EISA cards. 

3. The default configurations from the LI F volumeof the I nstall Media 
(named "CONFIG"). You may be asked for network information if it 
cannot be determined automatically. 

4. A copy of theconfiguration filecusTOM, in the LI F area of any disk on 
the system. 
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Installing and Configuring the Operating System 


Installing and Configuring the 
Operating System 

1. After you have booted the I nstall program, from the network or from 
the install media, as previously described, the I nstall interface will 
automatically be displayed as follows: 


Figure 2-6 


Welcome to the HP-UX Installation process! 

Use the <tab> and/or arrow keys to navigate through the following menus, 
and use the <return> key to select an item. If the menu items are not 
clear, select the "Help” Item for more information. 


Install HP-UX 


[ Run a Recovery Shell ] 
[ Cancel and Reboot ] 
[ Advanced Options ] 
[ Read Sys—Admin Message ] 


[ Help ] 


This Welcome screen is the first of several screens that will guide you 
through the installation process. Use your Tab key to highlight items 
on the screen. Press Enter to choose or activate the highlighted item. 

2. Select I nstall H P-UX. 

The I nstall program will continue. 

Configuring for Network Installation 

In the following screen, you will be asked for information about 
networking. 

If the system is NOT currently booted from a network, it will display the 
following: 


Figure 2-7 
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Installing and Configuring the Operating System 


If you plan to use a network software depot to load the operating 
system, you will need to enable networking at this time. 

Would you like to enable networking now?[y] 

Answering "n" means that you intend to install entirely from the media 
and the I nstall Kernel continues to load. 

Answering "y" brings up the following screen if you have more than one 
LAN card: 

(If you have only one LAN card, you will seethe Network Configuration 
screen next (Figure2-9). 


Figure 2-8 


More than one network interface was detected on the system. You 
will need to select the interface to enable. Only one interface 
can be enabled, and it must be the one connected to the network 
that can be used in contacting the install and/or SD servers. 


Use the <tab> and/or arrow keys to move to the desired LAN device 
to enable, then press <Return>. 


HW Path Interface Station Address 


12/0/2 


lanU 


0x080009150315 


[ 4/0/3 


lani 0x080009141404 


] 

] 


1. ChcxDsethe LAN interface that you will be using for this installation. 
(Notethat only Ethernet can be used for installation.) 

2. You will next see the following Network Configuration screen. Some 
of this information will have been filled in for you if you have 
configured the Dynamic Host Configuration Protocol (DHCP). See 
Appendix B, "Configuring for a DHCP Server,"for more information. 


Figure 2-9 
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Installing and Configuring the Operating System 

HP-UX INSTALLATION UTILITY NETWORK CONFIGURATION 

This system's hostname:_ 

Internet protocol address (eg. 15.2.56.1) of this host:_ 

Default routing internet protocol address:_ 

The subnet mask (eg. 255.255.248.0 or OxfffffSOO):_ 

Internet protocol address of the Install Server System:_ 

Is this networking information only temporary? [ No ] 

[ OK ] [ Cancel ] [ Help ] 

3. If not a I ready filled in, this information must beentered, if you plan to 
usethe network to install any portion of theoperating system or 
application products. (This information will not be required if you are 
installing the entire system from CD-ROM). An additional 

line, ("...Install Server System"), appears Only when booting from 
a network. 

4. For the question about the network information being temporary: 
"temporary" means that the network IP address will be used as 
default information during the install process and to fill in the fields 
of the system configuration screens. The "temporary" status will also 
prevent DHCP from retaining the "lease" on this IP, as it would if the 
network information were marked "permanent". See Appendix B, 
"Configuringfor a DHCP Server,"for detailed information on what 
leasing entails. 

You will see the system configuration screens after the OS is installed 
and the system reboots. 

The default response for this question is "no". I f you press the space 
bar (or Enter) when the cursor is on this field, "yes" will be displayed. 

5. Choose OK when you have finished with this screen. 
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Selecting the Root Disk 

If you have more than one target disk, after you have finished with the 
Install Welcome screen, you will see the Select System Root Disk screen. 
If you have only one disk, skipto "Viewing or Modifying Configuration". 


Figure 2-10 



NOTE Shortcuts 

Ti ps for usi ng the i nstal I i nterface: 

• Ifyou prefer to usethe keyboard to manipulatethe I nstall interface, 
you can do so by typing the underlined letter of an item (such as "C" 
for cancel). 

• For help, choose the Help button at the bottom of each screen. Press n 
or CTRL-f for context-sensitive help. 

• Use CTRL-k to get navigation key help. 


1. Select your root disk by using the arrow keys to highlight the line for 
that disk. (I n the above example, the system found two disks.) 
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Selecting the Root Disk 


2. With the desired disk highlighted, chcxase it by using Tab to select OK 
and press Enter. 

• If the disk you want is not shown, make sure it is turned on and 
connected to the system. You may select Cancel to exit this menu. 
If you do this, you will be presented with the option to restart the 
installation at the beginning of the configuration utility or scan 
the system again for disks. 
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Viewing or Modifying Configuration 

If you selected OK on the previous screen, or if you have only one target 
disk, you will next seethe Select Whole-System configuration screen. 
This screen asks for the file system layout you want. Standard 
Whole-Disk (non-LVM), LVM ("Logical Volume Manager"), or LVM with 
VxFS (J ournaled File System). 


Figure 2-11 



Workstation installation isshown as Standard Whole-Disk (non-LVM). If 
a disk is larger than 2 GB, LVM is required. 

The default for Servers is LVM configuration, with the exception of disks 
smaller than 1GB. In most cases, especially with multipledisks, you will 
want to configure as LVM. 

1. Use the arrow keys to highlight your selection. 

The descri pti ve text at the bottom of the screen changes for each 
highlighted selection. You can scroll through thetexttoget more 
information about each selection. 

2. Select the option you want, tab to OK and press Enter. You will next 
seethe View/Modify Basic Configuration screen. 
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Viewing or Modifying Configuration 


NOTE Starting from the H PUX 10.20 version, /stand is created as a 

separately mounted file system. The / stand filesystem will always 
reside on the first logical volume on the boot disk. 

The following default sizes will be used for the root and the boot file 
systems: 


Root FS "/" : 84 MB 

Boot FS "/stand" : 48 MB 

You can choose either H FS or VxFS as the root filesystem. 


For More Information To find out more about LVM and VxFS, see the manual System 

Administration Tasks. The basic procedure for installing the optional FI P 
Online] FS Product, which gives you the complete functionality of VxFS, 
is in "I nstalling the Optional Online] FS Product", in this manual. 


NOTE On a small root disk, it is better to load everything under the root file 

system ("/") and take advantage of a common pool of free disk space. 

If your system has multiple disks and you want to combine more than 
one disk into the LVM root volume group, specify Standard LVM 
configuration. 
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Viewing or Modifying Configuration 


View/Modify Basic 
Configuration 

Figure 2-12 

_ HP-UX Install Utility — View/Modify Basic Conf iRttr at ion 


You may modify tfie following basic configuration parameters. Press OK to 
save your changes. 


Primary Swap Size 

D tn.t.if m 


Secondary Swap Size 

[ 

None —>1 


Software Selection 

[ 

CDE Runtime 

Environment 

Load 10.20 Software Enhancements 

[ 

False —>3 


Software Language 

[ 

English 

->] 

Locale Setting 

c 

default (C) 


File system file name lengtii 

[ 

Long —>3 


/home Configuration 

[ 

Minimal 

->] 

How many disks in root group 

[ 

One 

->] 

Make volatile dirs separate 

[ 

True -> 3 


Create /export volume 

[ 

False “> 3 



[ OK ]_L Cancel J_[ Hel 


This screen allows you to modify disk configuration. The screen shown 
above is for an LVM configuration; not all of these fields will appear on 
the non-LVM screen. 

Pressing Enter (or the space bar) at each question will display a 
mini-menu for that item. If you need to change a parameter, use the 
arrow keys to highlight the selection on the mini-menu and press Enter 
again tochoosethat selection. 


NOTE To load only OS-related software without ON C-Hsoftware enhancements: 

leavethe value "false" for the question "Load 10.20 software 
enhancement s ". 


Help information which is specific to each parameter can be displayed by 
pressing fl (or CTRL-f) while the parameter of interest is highlighted. 

One of the parameters you can choose in this screen is "Software 
Language." Seethe manual Localized System Configuration Overview 
(HP Part No. B 3782-90095) for additional requirements for each 
language. 

You can also select the Locale setting for your system. This will 
determine other language-environment conventions such as time and 
monetary conventions in software messaging. 
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If you plan to configure multiple disks into the root volume group, you 
should ensure that the selection Make Volatile Dirs Separate is set to 
True. This allows the root filesystem to expand as needed and the 
volumes to bespread across more than the root disk. (See "Adjusting File 
System Size"for details on expanding a filesystem after installation.) 

Choose OK when you have made your selections. 
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Viewing or Modifying Configuration 


Configuring the Disk and File System 


Figure 2-13 


BBBiiMMm f M i‘i-n-1 irnTfn 


Any (ifjl.n on l.ln; 1 ol 1 ovn tij* disks will be: dcisl.roynd ... : 

Hardware Path Product ID Size (Mb) Disk Use Volume Group 

/- 


1 ?/o/i.s.o 


HP_Q7S60 




I vM 




— IJncoTfI 1 giirfid spncti I roiri l.liose (M:-;ks: '^Ib Ml) 

File systems and sv/ap space to be created: 
Mount Directory Size (Mb) Usaije 


Disk Group 



For trior e iidviiiiccd coti ti ii'urati on op ti oriti 


[ Modi I y Disk Pnrnmol.or; 
r Modify FS Parameters.. 


L tkiiicol J 




A screen display similar to this summarizes your configuration and 
allows you to make modifications by selecting Modify Disk Parameters or 
Modify FS Parameters. You can also accept the default values by tabbing 
toOK and pressing Enter. If you dothis, gotoFigure, "Loading the Core 
Operating System," in this chapter. 


• If you select Modify Disk Parameters or Modify FS Parameters, you 
will see a screen for additional parameters. (The disk in the example 
is in the root volume groupC'vgOO"). 

• Choosing Cancel will return you to the previous screen. 


NOTE If you choose OK, you may see a warning screen indicating that one or 

more of your target disks already has a file system on it. 

I n the warni ng screen, choose Conti nue to proceed, if you are not 
concerned about any data that may exist on the target disk. OR 

If you want to change target disks, choose Modify Configuration and 
Cancel to successively "back out" to the Root Disk Selection Screen. 
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Viewing or Modifying Configuration 


Specifying Disk Usage If you selected Modify Disk Parameters, in the screen shown in Figure 
2-13, you will see a screen similar to the foil owing: 


Figure 2-14 



Using this screen, you can modify disk usage or parameters. The most 
typical use of this screen would be to configure a second disk. 

For example, you could modify the disk configuration first, and then go 
on to modify the file system, as in the following sample procedures. Tab 
to OK and press Enter if values are satisfactory. 

Example: 1. On the Specify Disk Usage screen, select a disk with the arrow keys 

and tab to the fil l-i n fields to change any of the usage items. N ote that 
the "blank" fields allow direct entry of information; the bracketed 
fields have underlying mini-menus which you can display by selecting 
the item and pressing the space bar. I n a mini-menu, highlight an 
item by using the arrow keys and choose it by pressing Enter. When 
you have finished, use arrow keys to highlight Modify (if you have 
made modifications) and press Enter. 

2. To modify disk or volume group parameters (LVM), or simply usethe 
defaults, choose from the following actions: 
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• Tab to Modify Disk Parameters... and press Enter. You will see 
Figure 2-15. Go to the next section, "Modifying Disk Parameters". 
OR 

• Tab to Modify Volume Group Parameters and press Enter. You will 
see Figure 2-16. Go to the section "Modifying VolumeGroup 
Parameters". OR 

• Tab to OK and press Enter to leave the screen when everything is 
satisfactory. Go to the section "Loading the Core Operating 
System", in this chapter. 

Modifying Disk If you selected Modify Disk Parameters in the screen shown in Figure 

Parameters 2-14, you will seea screen similar to the foil owing: 

Figure 2-15 



NOTE Before you make any modifications to the sub-screens, please note the 

following: 

• Thedefault parametersareusuallysuitableand should not be 
changed unless your disk situation is unusual. 


Chapter 2 


47 


















Installing HP-UX 

Viewing or Modifying Configuration 


• I nitializing a disk ("mediainit") is both time consuming and genaaiiy 
unnecessary, except in theuniikeiy event that thedisk has incurred 
iow-ie/ei formatting damage due to a controi maifunction. 


if necessary, make any modifications and tab to OK. Then press Enter. 

Modifying Voiume if you seiected Modify VoiumeGroup Parameters (LVM oniy) in the 
Group Parameters screen shown in Figure 2-14, you wiii see a screen simiiartothe 
foii owing: 


Figure 2-16 



if necessary, make any modifications and tab to OK. Then press Enter. 

After you have viewed or modified the parameters in each sub-screen, 
you wiii seethe Specify Disk Usage Screen (Figure 2-14) again 
summarizing the current status of disk usage. 

Configuring Fiie if you seiected Modify (FS) Parameters in the screen shown in Figure 
Systems 2-13, you wouid seea screen simiiar to the foii owing: 
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Viewing or Modifying Configuration 


Figure 2-17 Configure File Systems 



On this screen, you can configure file system space and usage, and you 
can also change Logical Volume parameters or other file system 
parameters in subsequent screens, as needed. As with disk usage the 
default parametersareusuallysuitableand should not be changed unless 
your filesystem requirements areunusual. 

Example: You can change file system configuration by doing the following: 

1. Move the cursor to highlight the mount directory item, such as 
"/home", in the top box. Use the arrow key to move the cursor within 
lists, and use the Tab key to move between lists and major items. 

For example: 

a. Use Tab to move the cursor to the "Size" field, or another item in 
the lower half of the screen. 

b. Leave the default size or change it to another appropriate value. 
To edit, you can backspace over the old entry and type in a new 
one. For the fields followed by ">", highlight thefieid and press the 
space bar to get a mini-menu of selections. FI ighlight one of these 
and choose it by pressing Enter. 

c. When you have finished, choose Modify (for changing volumesize) 
or choose Add or Remove for other changes. 
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d. When you are satisfied with the parameters, choose OK to accept 
the changes and return to the System Configuration screen. 
Otherwise, choose Cancel to reject the changes and return to the 
previous screen. 
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Loading the Core Operating System 


Figure 2-18 



When you have finished with configuration or elected to use the default 
values by choosing OK at the System Configuration screen, you will see 
this screen. 

Note you will not be asked for theSD-UX server I nternet Protocol 
address, unless you have booted from the network. 

If you booted from media but you want to load theOS from the network, 
you can make this choice later when theinstall program prompts you to 
change media. Otherwise, if you booted from CD-ROM and you want to 
load the OS from the network, you will need to interact with SD in order 
to change sources. 

Toinstall the required bundles/products from the product media, the cold 
install process invokes the SD-UX swinstaii command. You can choose 
to work with this utility interactively or non-interactively. I nteracting 
with the swinstaii utility gives you additional flexibility in choosing a 
specific set of products/filesets. 

• If you choose No as in the example (to load the standard 

bundles/products without interaction), swinstaii will proceed with 
theinstall, loading the appropriate bundle, based on your software 
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NOTE 


CAUTiON 


Time Note 


selections in the View/Modify Basic Configuration screen (see Figure 
2-12). While doing this, it displays the activity logs (monitoring the 
install process as it happens) and the list of default values it uses to 
install the software. 

• If your server (or media) has needed applications on it, such as 
multi-user licenses or a C compiler, you will want to interact with 
swinstaii. In that case, choose Yes (to load bundles/products 
interactively). Then you will seethe swinstaii user interface. 

Many system administrators or users may want to customize individual 
products and filesets. This is easily done by interacting with the 
swinstaii Utility which "reads" the list of software available on the 
installation source and displays it. At this point, you may go through the 
list and "mark" individual filesets for installation and ignoreothers. You 
can also "open" bundles, products and filesets and list their contents, 
using the interface. Each software object also has its own description file 
which can be read to get more information about the item. 

If you interact with SD-UX, do not manually select the following ACE or 
Hardware Extensions bundles for loading: B6193xx, B6232xx, B6378xx, 
B6379XX. These are the ACE or Hardware Extension bundles and they 
are loaded by the cold i nstal I software, accord! ng to how the "Load 
Software E nhancements" selector is set.. 

• If you are installing from the network, the install utility will also 
request the SD-UX Server IP address and the SD-UX Server depot 
directory. You can also have a depot set up on the server using 
swcopY, and you can use swreg to register a mounted CD-ROM on 
the server. See Managing HP-UX Software with SD-UX for this 
version, for more information. 

• After you indicate your choice, the install utility will proceed with 
configuring your disk(s) and file systems. 

• The initial configuration will require about five minutes. 

• After the configuration is complete, the install process will proceed 
with loading the software. The load process will require 30 to 60 
minutes, depending on network performance and the number of 
products to be loaded. 

The system reboots after loading the software. 
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Specifying System Information 

When the installation ends and the system reboots, you will see a system 
information screen requesting the foil owing system information. If you 
are using a DHCP server, some of the IP address and host name 
information will already be filled in. (See Appendix B, "Configuring for a 
DHCP Server,"for further information on DHCP.) 

1. The hostname for your system. 

2. The region (e.g. "North America") for your time zone, or press Enter, if 
the selected item in the list is correct. 

3. The local time zone. Confirm the time zone, or press Enter if the 
information is correct. 

4. The local time. Confirm the time and date or press Enter if the 
information is correct. 

5. A password. Re-enter it as requested. 

6. The internet (I P) address of your host system. Confirm the host 
internet address or press Enter. 

7. If your system is connected to a network, fill in additional network 
parameters as requested. Otherwise respond "n" to the questions 
about additional parameters. Network information will typically be 
provided by your network administrator; not all of these items will 
usually be needed. 

Use Tab to move between fields: 

• Subnetwork Mask and Default Gateway. 

• Subnetwork Mask (for example, 255.255.248. o or 

OxfffffSOO). 

• Gateway Host Name. 

• Gateway IP Address. 

• Domain Name System (DNS). 

• Domain name. 

• DNS System Host Name. 

• DNS IP Address. 

• Network I nformation Service (NIS). 


Chapter 2 


53 



Installing HP-UX 

Loading the Core Operating System 


• NIS Domain Name. 

• The Setup Font Client screen enables you to save disk space by 
havi ng H P VU E access character fonts over the network. I f you 
wish to do this, you can click on Yes and provide any additional 
information. Otherwise, click on No. 

• I f you haven't al ready configured the network, the System 
Parameters screen gives you path information for the 

/sbin/set_parms 

addi_netwrk command. Click on Close or press Enter. 

• You will seethe boot checklist display, which should require no 
interaction. The initial boot of your system after a cold install or 
an update may take somewhat longer than later boots. 

You will seethe login interface for HP VUE (or CDE, if installed), 
or the terminal login prompt. Log in as root and press Enter at the 
request for password, unless you set a password duri ng the system 
information procedure. 
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Verifying and Completing the 
Installation 

When you have completed the OS installation steps, the system will 
automatically reboot from the new system disk. Then you will need to 
insert the Diagnostic/I PR disc and update with the Quality Pack bundle 
XSW700QPK1020. (For information on theQuality Pack, seethe Read 
Bd'ore Installing document, and "Some ACE Features", in Chapter One. 
TheQuality Pack is also replicated on the Extension Software CD. 

You may also want to start building (or re-building) your system by 
installing other software and data files, setting up printing facilities and 
connecting additional peripherals, as needed. 

To verify that you haveFIP-UX 10.20 (ACE or FI ardware Extensions) 
running on your system, execute the following command: 

$ uname -r 

To verify that ACE software is loaded on your computer, execute the 
swiist command: 

/usr/sbin/swlist | grep ACE 

Scan the swilst output for the B6193CA software bundle with a 
description similar to the following: 

Workstation ACE (199806) for HP-UX 10.20 

This indicatesthat thej unel998ACE software is installed. Ifyou do not 
see this line, ACE software has not been installed. 

Also, look for the following: 

Quality Pack (199806) for HP-UX 10.20 ACE 

Listing Installed Applications During Load 

You can list the contents of your install or update media at various levels 
of detail by using the List button or the View menu during an 
installation or update. To list all applications on your system, after 
FIP-UX is installed and booted, type the foil owing: 

swiist -1 bundle 
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This will list all SD-UX format software application bundles that have 
been installed in thedirectory on your system. To determine if ACE 
or Hardware Extension bundles are installed, pipe the command to grep 

ACE IHWE. 


The swiist uti I ity creates customizable I ists of software products that 
are installed on your local host or software that is placed in depots for 
later distribution. Seethe Managing HP-UX Softwarewith SD-UX (HP 
Part No. B2355-90080) manual or the manpages for swiist for more 
information. 

You can also use swiist with your install media to obtain a listing of 
bundles and products. 

Removing Unwanted Software/Filesets 

If it is necessary to remove software that has been installed on your 
system, usethe swremove utility. The swremove utility also 
unconfigures the software as it removes it. 

It is possible to remove your 10.20 ACE or Hardware Extension software, 
although the system may have to manually rebooted, as follows: 

1. Use swremove to remove the appropriate ACE bundle. 

2. Exit swremove session after the bundle is removed. 

3. cd / 

4. /etc/shutdown -r -y 0 

After the system has rebooted, the software will have been successfully 
removed from the system. 

Running freedisk 

Another method of removing filesets from your system is to usethe 
HP-UX freedisk command. The freedisk command invokes an 
interactive script that finds and optionally removes filesets that do not 
appear to have been used si nee they were originally installed by 
swinstaii. This command is best run AFTER your new system has been 
in operation for sometime Seethe manpageon freedisk for more 
information. Note, you should be familiar with the swremove command 
before you use freedisk. 


56 


Chapter 2 



Installing HP-UX 

Verifying and Compieting the instaiiation 


NOTE 


Creating a Recovery System 

You should immediately make a recovery version of your new system 
after you have successfully installed it. This will help you recover your 
system in case of problems. The Support Media User's Guide provides 
instructions on how to usethe copyutil disk copy utility to make an 
image of your system disk after installation. The manual is included in 
the Support M^ia available through Subscription Services or orderable 
from HP. You can also find information on restoring and backing up your 
system i n the manual I nstal I i ng H P-U X 11.0 and U pdati ng H P-U X 10.x 
to 11.0. 

Multi-User License Software: If you are loading H P-UX from a 
CD-ROM, multi-user licenses (to allow more than two users on the 
system) are on one of the additional Application CDs, which also 
contains optional products such as LVM disk mirroring. 

This means that, when your system reboots after loading the software 
from the first CD, no more than two users will be ableto log back in. If 
yours is a multi-user system, you must load your multi-user license from 
another application CD before bringing the system back online. You may 
want to set up a network depot to make this process easier. 


Installing Extension Software 

The Extension Software which comes with HP-UX contains essential 
patches and hardware-specific updates for the current version of HP-UX. 
If you are updating with theHP-UX Extension Software, please go to 
"Updating HP-UX Software"and "Using HP-UX Extension Software", in 
this chapter, to get information. The system will automatically reboot 
after updating with kernel-related Extension Software. 

Installing Applications Software 

For the procedures for installing additional software from CD-ROM or 
network depots, see "Updating HP-UX Software", in Chapter 3, 
"Updating HP-UX." Or see the manual Managing HP-UX Software with 
SD-UX. 
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Updating HP-UX 


Updating your system from the existing HP-UX lO.Ox, to HP-UX 10.20 
reieases invoives using swinstaii and other SD-UX toois with a 
standard source, such as a network server or CD-ROM, to instaii the 
appropriate bundies, products, or fiiesets. 

Upgrading means using a suite of toois (version 9.U 3 of the Upgrade 
toois) to update your system from H P-UX 9.0x to lO.Ox. For upgrading 
your system, refer to the manuai U pgradi ng from HP-UX 9.x to 10.x. 

• if you pi an to update from HP-UX 10.0 to 10.20, you wiii have to 
update your system first to H P-UX 10.01. 

• it is highiy recommended that you do a system backup before starting 
to do an update. 

• if you areupdatingfrom HP-UX lO.lOor eariier, you wiii havetofirst 
update SD-UX (the set of toois that inciudes swinstaii), using 
swgettoois, before you can run swinstaii. 

Executing swinstaii to update from 10.0,10.01, or 10.10 to 10.20 wiii 
not succeed uniess you first obtain and execute the swgettoois 
command found on the 10.20 media. This wiii update the SD-UX 
commands. Faiiure to update SD-UX from the oid version wiii resuit in 
error messages and faiiure of the update process. 

The instructions for using swgettoois are in "Updating SD-UX Before 
i nstaiiing/Updating Software", in this chapter. 

• if you ai ready have H P-UX 10.20 via i nstant ignition or thecoid 
instaii procedures in Chapter 2, "instaiiing HP-UX," go to "Updating 
HP-UX Software", in this chapter. 

• if you are doing an OS update from a patched version of HP-UX 10.x, 
after updating, you wiii need to remove oid patches using the 
cleanup tooi. See the note at the end of the update procedure. 
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HP-UX 10.20 System Requirements 

For general source media and system requirements for updating, please 
see "System Requirements" in Chapter 1, "Before You I nstall." 

You can use the SD-UX tools to update your OS to H P-UX 10.20 from 
either 10.10 or 10.01. For upgrades from 9.0x, seethe manual Upgrading 
from FI P-UX 9.x to 10.01. You can also use SD-UX to install or update 
applications. 

• FI P-UX 10.20, including NFS and LAN/9000, requires 16 MB of RAM. 

• Before you begin the update, you should be sure your target disk has 
the space needed to accommodate the new OS as wel I as your data 
files and all needed backups on disk. FI P-UX 10.20 requires 271 MB, 
including NFS, LAN software and X Windows. This means you should 
plan on a minimum of 525 MB for a standalone workstation. Disk 
usage numbers will vary with the SD-UX installation by a factor of 
20 %. 

I n general, the Disk Space Analysis phase of swinstaii will warn 
you if disk space is insufficient. Flowever, Disk Space Analysis does 
not currently check /var/adm/sw, where the database is kept, for 
temporary space usage. 

If you are running your system as LVM and /var comprises a single 
volume, be sure you have configured adequate space in the /var 
vol u me to accommodate t he u pdate fi I es. U pdate requ i res a mi n i mu m 
amount of free disk space of at least 20 M B to allow for the generation 
of the installed software database, among other things. 

1. Determineyourfreediskspacein /var by runningbdf /var and 
bdf /var/tmp. The default temporary directory is /var/tmp. 

2. Delete any files in this volume that you don't need. 

3. If necessary, set the environment variable tmpdir to point to a 
directory that has sufficient space. For example (for a directory 
dir): 

TMPDiR=/dir 

After setting this variable, export it, and kill and restart the 
swagentd process. 
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/usr/sbin/swagentd -r 

4. E nsurethat your system has at least 30 M B of swap enabled bd'ore 
start! ng the update process You can use swapinf o -mt and check 
the total free M B of swap space. Or you can use SAM to see how 
much swap you currently have. If you do not have enough swap, 
you can enable file system swap for the duration of the update 
(until system reboot) by using the following command: 

/usr/sbin/swapon /var/tmp 

The directory /var/tmp can be used if there is sufficient free 
space. If /var/tmp Isfull, then specify a different volume that has 
enough free space to satisfy the swap space requirement. 

Alternatively, you can shut down unneeded programs to make 
more memory and swap space available. This also improves 
performance, especially in 16 M B systems. 

• Before updating, you may wish to use /usr/sbin/swremove to 
remove unneeded filesets from your system. You can use the 
freedisk tool on a system which has been active for a timetodetect 
unused filesets. 


For More Information Refer to the current System Administration Tasks manual and the 
on Space Release Notes for HP-UX 10.20 for additional information on peripherals 

Requirements and disk space. 


CD-ROMs Used SeeChapter 1 for the Media list for this release. Note that two discs are 

required for updating to the current ACE 9806: Core and install..., 

and Diagnostic/IPR. 


NOTE If you are updating any networking products, such as FDDI or 

Token-Ring, which are not on theH P-UX I nstall and Core OS CD, please 
see "Networking Products on Additional Media". 


Starting the Source Media 

1. Notethat your multi-user license is typically supplied on separate 
media. 

2. E nsure that you have made a backup tape of your present system. 

3. Ensure that your system is booted and running HP-UX 10.x. You 
should have a term window opened. 
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4. Turn on the CD-ROM drive, if it is external to your HP-UX 10.x 
system. 

5. I nsert the CD-ROM into its drive. 

6. Wait for the busy lights to stop blinking. 

7. If necessary, identify the drive device, using the /etc/loscan 
-fn command. 

8. If you are using a CD-ROM, note that you will first have to mount the 
disc, using SAM or the mount(lM) command. If you do not use SAM, 
you can do the following to mount the disc: 

a. Put the CD into the CD-ROM drive. CD-ROM "busy light" should 
blink. 

b. Open a term window and, at the shell prompt, type the foil owing: 

mkdir /SD_CDROM Enter 

I f not created by cold i nstal Ial ready. 

mount / da//dsk/clt2d0 /sd_cdrom Enter 

The device name "clt2d0" should be replaced with whatever 
device name you found using ioscan in item 7 above. 
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Updating SD-UX Before 
I nstal I i ng/U pdati ng Software 

Before you can update to 10.20, you must extract the new version of 
SD-UX from the 10.20 CD or software depot from which you plan to 
update your system. If you are already running 10.20 or a 10.20 ACE, 
you can skip this procedure. 

Do not attempt to use the 10.01 or 10.10 version of swinstaii to update 
the system to 10.20. The update will fail. The swciuster command, 
used to update an NFS Diskless server, will also fail, since it calls 

swinstaii. 


To update SD-UX, you must first load the swgettools utility onto your 
system, and then use swgettools to get the new version of SD-UX. 

The swgettools command needs a temporary directory with at least 11 
MB of free space. By default, swgettools will usethe /var/tmp 
directory. If there is not enough space in the temporary directory 

swgettools will fail. 

You can tell swgettools to use a different temporary directory by 
means of the-t dir_path command-line option. You must do this if you 
do not have 11 MB free in /var/tmp. Usebdf /var/tmp to determine 
this. 

The swgettools Utility is shipped in the catalog/SW-DISI/pf lies 

directory. Depending on whether the 10.20 software is on CD or a remote 
system in a software depot, use cp, tar, or rep, respectively, to load 
swgettools ontoyour system. Skip to the section "SW-DIST 
I nstallation" below for more examples and other options. 

For example, to load swgettools from a local CD-ROM mounted at 
/SD_CDROM into /var/tmp, enter the following: 

cp /SD_CDROM/catalog/SW-DIST/pfiles/swgettools /var/tmp 

Now use swgettools to Update SD-UX. For example: 

/var/tmp/swgettools -s /SD_CDROM 

The expression -s /sd_cdrom indicates a CD-ROM drive mounted at 

/SD_CDROM. 
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CAUTION 

Further examples are in the next section. After you have updated 

SD-UX, you can use swinstaii to update your system to H P-UX 10.20. 

Do not reboot your system after running swgettools and before you run 

swinstaii Or swcluster tO Update H P-UX. 

If you do reboot, you must run swgettools again before updating 
HP-UX. 

From CD-ROM 

SW-DIST Installation 

To install the new sw-dist product from CD-ROM at /sd_cdrom, enter 
the foil owing: 

cp /SD_CDROM/catalog/SW-DIST/pfiles/swgettools /var/tmp 

/var/tmp/swgettools -s /SD_CDROM 

From Tape 

To install the new sw-dist product from tape at /dev/rmt/Om, enter 
the foil owing: 

cd /var/tmp 

tar -xvf /dev/rmt/Om catalog/SW-DIST/pfiles/swgettools 

cp /var/tmp/catalog/SW-DIST/pflies/swgettools /var/tmp/swgettools 

rm -rf /var/tmp/catalog 

/var/tmp/swgettools -s /dev/rmt/Om 

From Remote Depot 

To install the new sw-dist from a remote depot on system swperf at 
/var/spooi/sw, enter the following: 

rep swperf:/var/spool/sw/catalog/SW-DIST/pfiles/swgettools /var/ 
tmp 

/var/tmp/swgettools -s swperf:/var/spool/sw 

Updating SD-UX Without Root Access to the 
Remote Depot 

Option 1: 

If you area system administrator, you can instruct your users to use this 
procedure or Option 2 (below) for more restricted access, if you do not 
want to grant the users rep (. rhosts) access as root to the server. 
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1. Copy the swgettools script file (in the catalog/SW-OIST/pfiles 

directory) and the swagent. z file (in the 

cataiog/sw-GETTOOLS/pfiies directory) from the tape or CD toa 
location that your users have FTP access to. 

2. Tell the user to do the foil owing: 

a. FTP the two files into the /var/tmp directory on the system to be 
updated. 

b. Usechmod -i-x to make the /var/tmp/swgettoois script 
executable. 

c. Run swgettools and specify the remote depot location with the 
-s option (and, if necessary, -t to specify a temporary directory 
other than /var/tmp). 

Option2: This option assumes the users will be running swgettools specifyinga 

source depot on a remote server, and you do not want to grant them rep 
(. rhosts) access as root to the server. 

U sers can use the SD-U X swcopy command to copy the sw-gettools 
product from a registered remote source depot to a local depot prior to 
extracting the files. The remote source depot can be either a CD-ROM or 
a disk depot. 

Tocopy the SW-GETTOOLS product from the remote CD-ROM depot 
located at swperf :/var/spooi/sw to a local depot in /tmp/depot: 

swcopy -s swperf:/SD_CDROM SW-GETTOOLS @ /tmp/depot 

Then copy the swgettools script and the swagent. z filetothe 
/var/tmp directory: 

cp /tmp/depot/catalog/SW-GETTOOLS/pfiles/sw* /var/tmp 

Executethe swgettools script specifying the remote depot to update 
the sw-DiST product from the following: 

/var/tmp/swgettools -s swperf:/SD_CDROM 

NOTE If you will be using a temporary directory other then /var/tmp, then cp 

the swgettools script and the swagent. z file to the temporary 
directory you will be using, and specify its location on the swgettools 
command lineusingthe-t option. 


EXBmpIO: cp /tmp/depot/catalog/SW-GETTOOLS/pflles/sw* /usr/tmp 

/usr/tmp/swgettools -s swperf:/SD_CDROM -t /usr/tmp 
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Consult the swgettools(lM) man page (on a 10.20 system) or the manual 
Managing H P-UX Software with SD-UX for assistance with the 
following: 

• If you encounter an error during the execution of the swgettoois 
script. OR 

• If you want to see examples of using swgettoois with other types of 
media. 


66 


Chapters 



Updating HP-UX 

Updating HP-UX Software 


Updating HP-UX Software 

If you areupdating softwareon an existing H P-UX 10.20 or 10.20 ACE 
system you should begi n the update procedure at this poi nt. 

Otherwise, you should have installed the new sw-dist product first, as 
given in the previous sections in this chapter. Then do the following to 
start swinstall: 

On H P Workstations, you will be using a Graphical User Interface (GUI), 
by default. On H P Servers, you will be using a character-display 
Terminal User Interface (TUI) on a console. You will haveaGUI if you 
are worki ng from an Xtermi nal. 

Updating a Single System or Server Cluster 


1. For a Server serving Workstation clients, or for a non-clustered 
system, enter the Software Management area of SAM and select 
Install Software to Cluster/Local Host. Or enter the following: 

/usr/sbin/swinstall 

2. You will seethe swinstall Specify Source screen, as in Figure 3-1. 
Skip to the section "Specify Source Screen". 

U pdati ng a CI uster 

If you are updating Workstation cluster clients or a Workstation serving 
Workstation clients, enter the Software Management area of SAM and 
select I nstall Software to Cl uster. Or you can use swciuster, as follows: 

1. Enter the swciuster command for interactive mode: 

/usr/sbin/swcluster -i 

(swciuster will shut down the cluster clients if you are updating 
kernel software): 

You will seethe swinstall interface. The screens are similar to 
those used for the non-clustered procedure below. 

2. Select the default shared root (/export/shared_roots/os_700) in 
the interactive window. 
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3. Select the software source host and depot. 

4. Select software as desired, or Match what Target Has from the 
Actions menu. 

5. Select Install/Analysis from the Actions menu. 

6. After the analysis phase finishes, select OK to conti nue with the 
cluster install process. 

For screen details seethe non-clustered installation in the next section. 

Installing or updating an operating system or kernel software to a 
shared root shuts down any clients booted from that server and reboots 
the server. If you are installing non-kernel applications to a shared root, 
the clients will not be shut down and the server will not be re-booted. 

When the server has rebooted and finished the startup process, turn on 
the diskless clients. They will boot and configure the software. 

Note that, on a server-cl usta, this process will only update the 
(Workstation) cl ients 

If you are updating a large cluster, this process could take several hours. 


Updating a diskless cluster server from HP-UX 10.01 to 10.20 may result 
in the following messages appearing in the swagent. log file (located in 

/export/shared_roots/ os_7 0 0/ var/adm/sw). These warnings may 
be safely ignored. 

* Beginning the Batch Swmodify Phase 


WARNING: Cannot delete the definition for "/sbin/sh.UPG" from the 
fileset "OS-Core.UX-CORE". The file does not exist in this fileset. 

WARNING: Cannot delete the definition for "/sbin/lib/eisa/HWP0C70.CFG" 
from the fileset "OS-Core.UX-CORE". The file does not exist 
in this fileset. 


The listing continues, with similar messages referring to: 

/sbin/lib/eisa/ HWPXnnnn.CFG 
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Specify Source Screen 

Figure 3-1 
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1. Clicking on the field beside Source Depot Type displays a choice of 
Local CDROM, Local Directory, Local Tape, or Network 
Directory/CDROM. The latter category will get a remote source for 
the update. 

2. If the source depot/host name filled in is not the one you want, enter 
the correct one. You may also use the IP address for a host. 

3. If you click on Source Depot Path, you will get a listing of available 
depots on the source you have just specified. If the source is a tape 
device, you may need to type the device file name. The mount point 
for a CD-ROM should already exist as /sd_cdrom, if the system was 
cold-installed. For more detail, see the man pageswreg(lm). 

4. If you wish to limit the listing, click on Software Filter to see the list 
of filters protocols available. At the same time, you can select one or 
none. 

5. Click on OK. 

You will next seethe Software Selection screen. 

For More Information For information on the options for swinstaii, and to change the degree 

of detail for its logging functions, see the manual Managing FIP-UX 

Softwarewith SD-UX. 
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Software Selection 
Screen 


Figure 3-2 
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• On the Software Selection screen, highlight an item and click on the 
Actions menu item Open Item to see a listing of the contents of that 
bundle or product. You can also successively double-click on the 
selected item to show the contents at the next level of detail. To see a 
general description of the selected software, click on Show 
Description of Software from the Actions menu. Click on the OK 
button when you have finished with the description screen. 


If you want to match the general filesets and functionality you 
already have on your old system, choose Match What Target Has... 
from the action menu, AN D/ OR 


• To choose specific bundles/products to add to the Match What Target 
Has... selection, highlight the additional item, and then choose Mark 
for I nstall from the Actions menu. (You can also usethe right mouse 
button to mark for install). 

• To start the install process, choose I nstal I (analysis)... from the 
Actions menu. You will see the foil owing screen (superimposed): 
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Install Analysis Screen 
Figure 3-3 
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Logfile... 
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OK 
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1 Help 


• By clicking on the Logfile button, you can open the logfileto monitor 
the progress of the analysis. You will also see a listing of files already 
on the target system which will be reinstalled in new versions. The 
Disk space... button will become accessible after the analysis process 
is complete and you can view the results (see Figure 3-4). 

• Click on OK to proceed. 

Time Note The analysis phase requires 5 to 10 minutes. 


Chapter 3 


71 

















Updating HP-UX 

Updating HP-UX Software 


Disk Space Anaiysis 
Screen 

F igure 3-4 _ 

I nie View Options Actions ^ ^ Help 

Target: swagain:/ Sizes shown in Kbytes. 

All affected file systems on swagain:/are listed. 
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File System 
Mount Point 
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After 
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/ -> 

9271 

8069 

83% 

0 

/opt -> 

48523 

20856 

65% 

0 

/usr —> 

78022 

38919 

84% 

0 

/var —> 

6860 

3683 

83% 
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1. The Disk Space Analysis gives you an estimateof avail able disk space 
vs. requirements for the new system. 

If disk space is a concern, you may want to look at graphics and 
related products especially for possible deletion. For example, in case 
you are running a Server with a character terminal console, you may 
not want to update graphics products. 


NOTE If you are updating from an H P-VUE bundletoaCDE bundle, the /usr 

filesystem will undergo significant expansion. This expansion may 
exce^ the default file system size set by Cold Install for /usr. See 
"Adjusting File System Size", in Chapter 4, 'Troubleshooting Your 
I nstallation,"for information on resetting file system size. 


2. Ensure that the /var 'Available After" space is at least 20 MB. (The 
screen shown indicates only about 6 MB, which is insufficient and 
would require deletion of old log and tmp files in /var/adm and 
/var/tmp.) 
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Time Note 


After Logging in 


3. Close the Disk Space confirmation window to see the analysis 
wi ndow. 

4. When the disk analysis is satisfactory, choose OK on the Install 
Analysis screen to proceed with the update. 

5. A confirmation screen will appear, to which you can respond Yes or No 
as to whether you want to continue with the installation. 

Note that, up to this time, you can "back out" of any action by clicking on 

Cancel in order to return to previous screens, for example, in order to 

adjust the selection of filesets being updated. 

6. You will see a second confirmation screen warning you that a new 
kernel will be loaded (in case you are updating H P-UX or a 
kernel-related patch bundle), and this will necessitate a reboot. 
Respond Yes, if you wish to go ahead. 

7. You will see an install status screen which monitors the current 
progress of the installation, including the time remaining. 

8. I f you want to keep track of the progress of messages and scri pts 
being run during the load, you can keep a logfile window open during 
the process. Do this by clicking on the Logfile button, on the status 
screen. 

• A typical HP-UX update, if done from a network server, will require 
one to two hours. Systems with 16 M B of memory wi 11 requi re 
considerably longer. 

• At the end of an H P-UX update, you will see a confirmation message 
and reboot warning (with about 30 seconds delay until shut down). 

• As the system reboots for the first ti me, configure scri pts run for the 
new filesets so you can expect a first boot time of several minutes. 
Subsequent reboot processes will not take as long. 

1. The login screen appears after the system has rebooted. Log in at this 
time. 

2. Check the foil owing I ogfi I es for any messages, including warnings, 
rel ati ng to the update: 

/var/adm/sw/swinstall.log 
/var/adm/sw/swagent.log 
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For an OS update, you will also need to repeat the update steps with the 
appropriate bundle on the HP-UX Extension Software which came with 
your H P-UX media. This provides core-related patches for the current 
version of HP-UX. (See"Using HP-UX Extension Software", in this 
chapter, and the patch descriptions on the disc.) The system will 
automatically reboot after updating with this bundle. 

If you are updating the OS of a previously-patched HP-UX 10.x system, 
you will need to remove the old patches after installing. The cleanup 
tool is available to accomplish this selectively by examining the I PD and 
removing references to old patches. You can get cleanup via the patch 
PHCO_12140, availablefrom your HP support service. 

The H P-UX 10.20 CDE filesets do not contain updated versions of 
SharedPrint or HP VUE files. Therefore, when updating from HP VUE to 
CDE, the old versions of SharedPrint or VUE remain on the system. Asa 
result, you will see SharedPrint and VUE errors appearing in the 

swagent. log, and the swverify . log (if swverify has been run). 

These messages can beignored, as no functional problems areimplied. 
The foil owing filesets will produce these failed verify error message: 

SharedPrint.SHP-ENG-A-MAN 
SharedPrint.SHPRNT-CLI 
SharedPrint.SHPRNT-PCL 
SharedPrint.SHPRNT-SRV 

VUE.VUE-RUN 
VUE.VUE-HELP-INFO 
VUE.VUE-MAN 
VUE.VUE-RUN-AUX 

(Non-English systems will display the localized fileset names.) 

I n addition, note that your 10.01 and 10.10 files will work on H P-UX 
10.20, as binary compatibility between versions has been maintained. 
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Updating Non-Interactively from Media or 
Network 

For a generic update where no "customizing" is required, you will be 
using theswinstaii tool non-interactively, with a general instruction to 
"match what the target has" in order to load the updated versions of the 
samefilesets as you have on your current system. Note that you cannot 
update non-i nteractively from a multiple-media set. 

1. If you are using CD-ROM, ensure that the drive is turned on and that 
the medium is inserted in the drive. 

2. At a shell prompt, enter the foil owing: 

swinstall -x match_target=true -x autoreboot=true -s d0/ice_file 

Enter 

Specify the device_filefor your, CD-ROM drive, or network source. For 
example 

/SD_CDROM/Clt2d0 

or similar, for a CD-ROM 

or 

hostname: / depot path 
for network sources 

You will see warning messages in case filesets are found on the target 
system that are not on the source. 


NOTE You will alsoneedtorepeattheabovesteps with the appropriate bundle 

on theFIP-UX Extension Software. (See "Using FIP-UX Extension 
Software" and the patch descriptions on the disc.) The system will 
automatically reboot after updating with this bundle. 


Using HP-UX Extension Software 

For core-specific patches to FI P-UX 10.20, you will have an Extension 
Software CD-ROM containing Workstation and Server 10.20 Patch 
Bundles. (If your system came with I nstant Ignition (pre-loaded) FI P-UX, 
your Extension Software is on the disk and will load automatically.) I n 
the event that you need to apply core-specific patches to your system, you 
will use the same SD update process with theExtension Software as for 
other types of 10.x software. 
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TheExtension SoftwareCD will contain critical patches relating to the 
10.20 core software only: 

The 10.20 bundles are contained in SD depots (the update format used 
for H P-UX 10.x). I n addition, these will be identified for Series 800 
(s800_io. 20) or Series 700 (s700_io .20). 

• You should first identify the bundle which is appropriate to your 
system(s). 

• Specific documentation for each bundle is kept in the 
/SD_CDROM/READMEFiRST/ directory. Before installing from a Patch 
Bundle, you can print the appropriate Readmefilefor that bundle. 

• Use the install procedure given in this chapter "Updating HP-UX 
Software" to install the patch bundle, 

• Use swinstaii or swciuster, as appropriate. 

• Set Source Depot Path to /sd_cdrom/io .x/s700_io .20 or 
/SD_CDROM/10.X/s800_10.20. 

• F rom the Actions menu, select M atch What Target H as. 

• Perform installation analysis (Actions ^ I nstall (analysis), if 
needed. 

• If there are no errors, proceed with the installation at the prompt 
message. 

• To get general information about patching your system, seethe 
following files in /usr/share/doc: 

Patch_pgm.txt 
sw_patches.txt 

Or refer to the xswtutoriai. txt file on the Extension Software 
CD-ROM. 

Adding Additional Functionality 

In case you need to add more bundles for the new functionality of HP-UX 
10.20, such asj FS or NFSD filesets, use the "Match What Target Has" 
option described in this chapter, and then select additional bundles 
which you have purchased. 

If you need further details, seethe manual Managing H P-UX Software 
with SD-UX. 
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Networking Products on Additional Media 

I f you are usi ng certai n networki ng products or other I ndependent 
Software Units (I S Us) which are not present on the core H P-UX CD, then 
you may need to fol low modified update procedures. Some of the 
networking products affected include FDDI, Token-Ring and lOOVG 
AnyLan, which are provided on the H P Applications CD-ROM. 

Since optional networking products are shipped on separate media from 
the CORE H P-UX, their drivers are removed from the kernel during the 
update process. This means that if you update using the core medium or 
a depot made from it, the optional networki ng wi 11 not be avail able after 
reboot. 

If the networking which was removed provides access to the remote SD 
depot or CD-ROM drive, then, after reboot, any swinstall of applications, 
including networking will need to be performed from a local CD-ROM 
drive. 

An alternative is to use swcopy to create a combined core and 
Applications depot and use that depot as your swinstaii source. 
Since a combined depot contains the new revisions of the networking 
products, their drivers will be reinstalled before reboot and so the 
networking they provide will be available after reboot. 

I f you have a custom update tape provided as part of you H P software 
support contract, then it is normally already combined and you do not 
need to create a combi ned depot, as long as the update tape, or any depot 
made from it, contains the HP-UX core software and the optional 
networking software which you need. 

Installing the Optional OnlineJ FS Product 

HP Online] FS is the advanced optional bundlefortheVxFS FileSystem. 
You can use the capabilities of OnlineJ FS to perform certain key 
administrative tasks on mounted VxFS filesystems. Because you can 
perform these tasks on mounted file systems, users on the system can 
continue to perform their work uninterrupted. 

These tasks include: 

• Defragmenting a file system to regain performance. 

• Resizing a file system. 

• Creating a snapshot file system for backup purposes. 
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You can install it with swinstaii in the following order: 

1. I nstall thej ournalFS product, if it is not already installed. 

2. Install two HP Onlin^ FS bundle fi I esets. 

(AdvJournalFS.VXFS-ADV-KRN and 
AdvJournalFS . VXFS-ADV-RUN). 

During the I nstall, swinstaii will edit the /stand/system file, rebuild 
the kernel, and reboot the system to bring the new kernel libraries into 
memory. 

For more information about installing and using VxFS and H P 
Online] FS, seethe manual H P-UX System Administration Tasks, 
Chapter 4. 
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Network Install 

The following are some items to check if you have problems during the 

install process: 

I f your system fai I s to fi nd a boot server, check the fol Iowi ng: 

1. M ake sure you are usi ng the correct boot command (you must use the 
"install" keyword for newer Workstation (Series 700) systems). For 
older systems, you may need to enter the boot command two or three 
times. 

2. Check for error messages on the server, logged to the file 

/var/adm/syslog/syslog. log. Look for instl_bootd messages. 

3. Makesurethat the /etc/insti_boottab file contains at least one 
IP address that is valid for your network. 

4. Make sure the server for the install kernel is on the same subnet as 
the system you are trying to boot. (The install server itself does not 
need to be on the same subnet). 

5. If the file /var/adm/inetd. sec exists and has a tftp entry, make 
sure it allows access to the addresses listed in /etc/insti_bootab. 

6. If your system has multiple Ian cards, make sure /dev/ianO you 
pick the one connected to the proper network. 

7. Check to see that /var/adm/sysiog/sysiog. log has an entry 
such as the fol I owing: 

inetd[306]: instl_boots/udp: Unknown service 

If there is also an entry in your local /etc/services for 
insti_boot s, check to See if your system is set up to use NIS. I f so, it 
may be that the version of /etc/services supplied by your NIS 
server needs to have the entries for insti_boots and insti_bootc 
added. 
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Media Install 

If your installation from the media fails, check the following: 

1. If you are using a CD-ROM as a depot for updating or installing 
software, ensure that the CD-ROM is mounted, using the mount 
command, before you attempt to use it as a source. 

2. Ensure that connections to drive(s) and I/O cards are secure. Remove 
and replace cables or cards if a loose connection is suspected. You 
would want to do this, for example, if the system is unable to contact 
the drive. 

3. I f you are usi ng DDS-Format tape and forget to change source tapes, 
you may see the foil owing error: 

"loopback:/dev/rmt/Om": An I/O error occurred while performing this task. 

The swinstaii uti I ity dispiays this message when it reads an i nstal I 
tape that you have inadvertently left in the drive, and which does not 
have any SD information on it. 

Adjusting File System Size 

If therequired file-system size for the bundleyou install exceeds that file 
system limit set by your disk installation, you will get an error condition 
during install. You can use ivextend and extendfs in this situation to 
create a larger file system. 

You might have a problem updating your system(s) if the /usr volume is 
too small. The previous default size was 300 M B, and depending on 
which bundleyou are updating, you might require more. 

If you try an update, swinstaii will determine how much disk space is 
required. If there isn't sufficient space, swinstaii will report an error 
like this: 

ERROR: The used disk space on filesystem "/usr" is estimated 
to increase by 57977 Kbytes. 

This operation will exceed the minimum free space for this 
volume. You should free up at least 10854 Kbytes to avoid 
installing beyond this threshold of available 
user disk space. 

I n this example, you would need to increase the file system size limit of 
/usr by 10 MB, which actually needs to be rounded up to 12 M B. 
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Here are the steps required for increasing the size limit of /usr: 

1. Determine if any space is available by entering the following: 

/sbin/vgdisplay 

You should seea display I ike the following: 


- Volume groups - 
VG Name 

/dev/vgOO 

VG Write Access 

read/write 

VG Status 

available 

Max LV 

255 

Cur LV 

8 

Open LV 

8 

Max PV 

16 

Cur PV 

1 

Act PV 

1 

Max PE per PV 

2000 

VGDA 

2 

PE Size (Mbytes) 

4 

Total PE 

249 

Alloc PE 

170 

Free PE 

79 

Total PVG 

0 


The "Free PE" indicates the number of 4 MB extents available, in this 
case this is 79 (equivalent to 316 MB). 

2. Enter the following: 

/sbin/shutdown 

Change to single user state. This will allow /usr to be unmounted. 

3. Enter the following: 

/sbin/mount 

You will see a display similar to the following: 

on /dev/vgO0/lvoll defaults on Sat Jan 28 23:19:19 1995 
/usr on /dev/vgO0/lvol7 defaults on Sat Jan 28 23:19:28 1995 

4. Determine which logical volume maps to/usr. This should be 

/dev/vg00/ivoi7 by default. 

5. Extend the size of the logical volume by entering the following: 

/sbin/lvextend -L $Old SpaC6 + nav SpaC6 /dev/vg00/lvol7 

This extends the size of the logical volume. 

For example, 

/sbin/lvextend -L 332 /dev/vg00/lvol7 

This will make this volume 332 MB. 
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6. Executethefollowingcommand: 

/sbin/umount /usr 

This is required for the next step, since extendfs can only work on 
unmounted volumes. 

7. Executethefollowing command: 

/sbin/extendfs /dev/vg00/rlvol7 

This extends the file system size to the logical volume size. 

8. Finally, executethefollowing commands: 

/sbin/mount /usr 
exit 

9. Go back tothe regular init state (3 or 4). 


Chapter 4 


83 



Troubleshooting Your Installation 

Large System 


Large System 

If your arerunninga system with a largenumba of filesystems, note the 
following possible problem areas: 

1. On a large system such as a T500 with a very large number of disk 
drives (such as 50 or more), you may see messages such as the 
following, during the system analysis phase of cold install. 

Out of inode- can't link or find disk 

or 

Write failed, file system is full, 
or 

File system full. 

2. To reduce the likelihood of this problem occurring, before you do the 
installation you should turn off any disks you don't plan to use for the 
installation process and start over. 

3. After the system is cold-installed, you may wish to add back all the 
file systems that existed under the previous installation, either 
manually or using SAM. However, for a large number of filesystems 
(for example, over a hundred), some tables in the kernel may be too 
small to allow correct booting. This is because the newly-installed 
kernel contains default values for kernel tables sizes, and does not 
allow for special configurations made to the kernel installed 
previously. 

For example, thefirst boot after adding the file systems may result in 
error messages displayed to the console, such as the following: 

inode: table is full 

proc: table is full 

file: table is full 

Additionally, the boot may fail in various ways. For example, you may 
be ha veto do file system repair manually. 

• If this is not possible, the kernel may need to be re-configured 
before booti ng. The fol Iowi ng setti ngs should al Iow the kernel to be 
booted, but may not be optimal for the system: 

- ninode = 2048 (default is 476) 

- nproc = 1024 (default is 276) 

- nfile = 2048 (default is 790) 

• Alternatively, you may wish to re-configure the kernel inoneofthe 
following ways: 
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• By raising maxusers toa large value, such as 200 . 

• By selecting an appropriate bundle of SAM-tuned parameters 
from the SAM Kernel Configuration Actions menu. 

You should determine the correct configuration for your system. 

Note that this problem does not appear to affect the Upgrade process 
(updati ng from H P-U X 9.0x), si nee duri ng U pgrade, the new kernel 
parameters are derived from the previous kernel. 
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A Sample Configuration File 


The H P-UX cold-install process is driven by information stored in 
configuration files. There arethree primary locations where a network 
cold-install can find configuration file information on the server: 

1. I n the area accessed by the insti_adm (iM) tool. This information is 
immediately available to clients when they boot. The data stored in 
this location is limited to 8 KB. 

2. I n the file /usr/lib/sw/hpux . in St all/con fig. local. This 
information is available after the client enables networking. It does 
not have a fixed size limit. 

3. The file /usr/iib/sw/hpux . instaii/conf ig is wherethe default 
configuration information that comes with HP-UX is stored. 

Please see the i nstl_adm(lM) and i nstl_adm(4) manual pages for more 
details. 

The following set of examples may be useful when saved toa file, and 
then installed using the insti_adm -f filecommand: 

# Set the default netmask and gateway for all clients 

# (can also be set using instl_adm with -m & -g options) 

netmask = "255.255.248.0" 
gateway = "15.1.48.1" 

# Set the default install/tftp server: 

server = "15.1.54.114" 

# Set the default hostname, IP address and disk to use as the 

# root disk for the system matching the lan-link address shown: 

LLA_ADDR == "08000941C3BD" { 

system_name = "swig" 
ip_addr = "15.1.54.104" 
best = disk[52.2.0] 

} 


# Specify the networking information for another system, and also 
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# specify that the installation should be done non-interactively: 

LLA_ADDR == "08000978BBBB" { 

system_name = "swbba" 
ip_addr = "15.1.54.138" 

RUN_UI = FALSE 

# Give users 10 seconds to respond to warnings before 

# continuing with the automatic installation: 

env_vars +="INST_ALLOW_WARNINGS=10" 

} 

This examplecan be added to the/ usr/ lib/ sw/ hpux.install/ configlocal 
file. It does not have the same 8 KB restriction as the examples above. 

# Specify the possible SD-UX servers and depot locations. This example 

# also shows how to use the "use model" variables to provide a 

# selector that the user will see during the install: 

radio_sel { 

[ "Depot Server:.*" ] 

} 

"Depot Server:Jupiter" { 

sd_depot_dir = "/depot/hp-ux_700" 
sd_server = "15.1.54.112" # Jupiter 

} 

"Depot Server:Orion (CD-ROM)" { 

sd_depot_dir = "/SD_CDROM" #depot on CD-ROM 
sd_server = "15.1.54.20" # Orion 

} 

# For systems matching these lan-link addresses, specify that 

# they execute the shown post_config_cmd. This particular 

# post_config_cmd will copy over some extra files and some files 

# that are specific for each system using tar(l) and remsh(l). 

# The result depends on what is copied over, but if the files 

# consist of the /etc/rc.config.d/netconf and other configuration 

# files, the system will boot up without the need for further 

# manual configuration. 

LLA_ADDR == "08000978BBBB" | LLA_ADDR == "08000941C3BD" 

{ 

post_config_cmd=" 
cd /; 

remsh 15.1.54.114 \"(tar -cf - -C /sdux/systemenvs/generic . \ 
-C /sdux/systemenvs/'hostname' .)\" I tar -xvf 

swinstall -s 15.1.54.112:/languages/depot XDB; 

# If a RUN_ME file was copied over, run it: 

[ -X /RUN_ME ] & /RUN_ME" 

} 


# Define a whole-system level use model for a system, and 

# make it the default for that system (note that this is 

# the same system that was configured to do an automatic 

# install in the previous section). 

init "SYS:Custom config for swbba" = (LLA_ADDR == "08000978BBBB") 
"SYS:Custom config for swbba" { 

init "Software Selection:Runtime Environment" = true 

init "Software Language:Japanese" = true 

init "Disk Layout:Logical Volume Manager" = true 
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# Load the ASX bundle from a different depot during the 

# post config phase (in addition to other post_config_cmd). 

post_config_cmd += " 

swinstall -s 15.1.54.112 :/asx B3782CA_ABJ" 

# For LVM configurations, adjust the volume size 

# for /var and create a /extra volume: 

"Disk Layout:Logical Volume Manager" { 
volume_group "vgOO" 

{ 

logical_volume { 

mount_point = "/var" 
usage = HFS 
size = 100Mb 
nbpi = 2048 

"File system file name length:Short" { 
file_length=short 

} 

} 

logical_volume { 

mount_point = "/extra" 
usage = HFS 
size = remaining 

} 


} 

# Define a new software selection that will appear along with 

# with other software selections. Note that the software language 

# specification will be ignored when this is selected. 

"Software Selection:Software config for our office." 

help_text "This is a custom software selection that selects only what 
our office needs. (Desktop, ANSI-C, and our own software)" 

"Software Selection:Software config for our office." { 
sd_software_list = " 

Product_Name 

Product_Number 

OurSW 

II 


When a system is installed, the configuration that was selected for that 
system is stored in the/ usr/ lib/ sw/ hpux.install/ configlocal file. A 
system that is configured as a network cold-install server will provide its 
own configuration to its clients as an option from which the user can 
select. 

It is also possible to concatenate another system's configlocal filetothat 
of the server's in order to have multiple configurations available to 
clients. Alternatively, the configlocal file may be hand-crafted (as shown 
in the previous example) to make slight modifications to the default 
configuration. 
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rep systeml:/usr/lib/sw/hpux.install/config.local /tmp/cfgl 
cat /tmp/cfgl >> /usr/lib/sw/hpux.install/config.local 

rep system2:/usr/lib/sw/hpux.install/config.local /tmp/cfg2 
cat /tmp/cfg2 >> /usr/lib/sw/hpux.install/config.local 

Then run the insti_adm command to test the configuration syntax 
before proceedi ng: 

instl_adm -T 


90 


Appendix A 



Configuring fora DHCP Server 


B 

Configuring for a DHCP Server 

Appendix Contents 

The H P-UX 10.20 version of the HPUX 1 nstall and system boot tools 
supports retrieving network information via the Dynamic Host 
Configuration Protocol (DHCP). This appendix gives the details of 
setting up DHCP. 

• Using DHCP Services: Overview. 

• Setting Up a DHCP Server. 

• Details on the DHCP Services. 

• Enabling DHCP on a System Not 1 nitially Configured with DHCP. 

• Background 1 nformation on DHCP Design. 

• For More 1 nformation (man pages and URL). 
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Using DHCP Services: Overview 

DHCP provides the following features: 

• Allows for dynamically allocating IP addresses and hostnames. 

• Automatically supplies most of the networking defaults that are 
requested during a system installation or first time boot. 

• Provides for on-going IP address maintenance via a concept of an "I P 
address lease". Having a lease on an IP address means that if the 
system "goes away" for a specified period of time without renewing 
the lease, then that IP address can be given to a different system that 
request a new IP address lease. 

• Assists in reestablishing valid network parameters when a system 
has been moved from one DHCP-managed network to another. 

The environment where DHCP works best is where the foil owing 

conditions and restrictions exist: 

• When a range of currently unused IP addresses can be allocated for 
use during new system bring-up. 

• When the IP address-to-hostname mapping can be made ahead of 
time (before the system to use it is installed). And this mapping can 
be configured in the name services database before installing a 
system. 

• When the IP address and hostname that get assigned to a system are 
not i mportant. A system wi 11 keep the same IP address and hostname 
for as long as it renews the lease. However the original assignment is 
arbitrary. 

• When the person i nstal I i ng the systems does not desi re to choose a 
hostname for the system, but rather accepts the one already 
registered for the IP address supplied by DHCP. This will ensure that 
the system will be recognized immediately by its hostname. 

• When existing systems that did not use DHCP before will continue 
not to use it. Or, if they did, they would be willing to accept an 
arbitrary hostname and IP address. This is the same as a with a new 
system. There currently is no tool aval I able for pre-loading the DHCP 
database with existing IP addresses and identifying the systems they 
belong to. A tool to do this may be available in a future release. 
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Setting Up a DHCP Server 

Once you have decided that using DHCP will provide a benefit, you will 
need to follow the steps below to set upa DHCP server. Note that only 
one DHCP server per network subnet is required. On the server system: 

1. Allocate a set of currently unused IP addresses (preferably a 
contiguous block of addresses). For example: 

15.1.48.50 - 15.1.48.80 

2. Pre-assign and register hostnames tothe IP address allocated above. 
Using the -h option tothedhcptools(lM) command may be useful. 

For example, the following line: 

dhcptools -h fip=15.1.48.50 no=30 sm=255.255.255.0 hn=devlab## 

This command will create a file /tmp/dhcphosts that can be 
incorporated into your /etc/hosts or dns/nis database. 

3. Designate a system to act as the DHCP server for your network. This 
should be a system that is "always" availableto it's clients. 

4. UsetheSAM application to configure the DHCP services on this 
server. To do this: 

a. Start the interactive SAM application by typing sam. (Note, you 
may need to set your display variable to use the graphical 
version) 

b. Doubleclick on the icon Networking and Communications. 

c. Doubleclick on the icon Bootable Devices. 

d. Doubleclick on the icon DHCP DeviceGroups Booting From this 
Server. 

You should now see a screen that lists any DHCP groups already 
defined (there may not be any if DHCP is not already configured). 

e. To add the new group of IP addresses which you allocated in Step 
1, click on the Action menu item and choose Add DHCP Group. 

This should bring up a form with parameters to fill in. 

f. Now you will need to fill in the information on this screen. Some 
information may require additional research if you are not 
familiar with the terms or with your network. 
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Group 

Name: 

This can be any name that isn't already defined 
as a DHCP group. For example: groupi 

Subnet 

Address: 

This is the portion of an 1P address that is not 
masked off by the subnet mask (see below). If 
you don't want to figure this out, then just enter 
one of the IP addresses in the range you picked 
along with the correct subnet mask and SAM 
will take care of the calculation. For example: 
15.1.48.50 

Subnet 

Mask: 

This depends on the "class" of your network, and 
basically determines how an 1P address is 
separated into a network number and a host 
specific number. Press FI in this field for more 
information. For example: 255.255.255.0 

Subnet 

Address 

Pool: 

Press this button to select the range of 1P 
addresses that you allocated in Step 1. A new 
screen will be displayed where you can enter the 
Start and E nd address. 1 f there are addresses 
within the range that you picked that you do not 
want allocated via DHCP, you can use the 
Reserved Addresses button to specify those (or 
ranges of them). 

Allow Any 
Device 

Class: 

The SAM default is to allow any type of DHCP 
device to use the group of 1P address you are 
configuring. This may be undesirable if you use a 
different method (or a different DHCP server or 
group) for managing systems such as PCs 
running Win95™ or NT™. 
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Automatic 
Allocation 
to Bootp 
Clients: 

1 f you want this range of addresses to be used 
only by H P-UX systems, then unselect this 
button, and enter the text: 

"HewlettPackard. HP-UX" in the text field 
provided. 

Leave this option disabled. Enabling it will 
cause problems for bootp devices such as 
printers and terminals which rely only on their 
preconfigured server to respond to their boot 
request. 

Accept 

New 

Clients: 

Leave this option enabled. 

Address 

Lease 

Time: 

The lease time should be set sufficiently long so 
that if a client system is temporarily out of 
service (off) for a time, its lease will not expire 
too soon. 

1 nfinite leases will never expire and disable the 

1 P-address reclamation features of DHCP. For 
example: 2 weeks. 

Boot file 

name: 

You can leave this field blank. 

Additional 

Params.: 

There are many parameters that can be specified 
in this screen for such things as the default 
routers, time server, DNS server, and Nl S 
domain. You can specify as much or as little as 
you like in this area. 

Only the more basic parameters are actually 
used by installation and boot configuration tools. 

Callback 

Routines: 

None is necessary. 
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g. Once the parameters are all filled in, then pressOK on theAdd 
DHCP Group screen. SAM will then make the modifications to the 

/etc/dhcptab file. 

h. Youwill now want tousetheAction menu to Enable boot Server (if 
it is not already enabled). 

5. Now, new systems that are installed with HP-UX 10.20 (or newer) or 
booted with a pre-installed 10.20 (or newer) version of H P-UX should 
contact this server to get an IP address lease and other network 
information provided by the server. 

• When doing a cold install of the HP-UX Operating system (version 
10.20 or newer): 

The installation tools will broadcast out on the network for any 
available DHCP servers. The first server to respond will be chosen to 
provide the default network information that the user is presented 
with. 

I n the network parameters screen during a Cold I nstall, you seethe 
question: "Is this networking information only temporary?". The 
"yes" or "no" answer to this implies the following: 

• "no": Answering "no" (the default) means that if the IP address 
and hostname were leased from an DHCP server, then that lease 
will be retained after the install is done, so that the first boot of 
the system will attempt to renew the same lease. 

• "yes": Answering "yes" implies that the IP address and hostname 
lease should be returned tothe server after the installation is 
complete. I n this case, the first system boot will try to get a new 
lease. This is most useful when the system is being installed on a 
network that is different from its final destination. 

(This answer tothe question can also be set in the configuration 
file with instl_adm(lM) using the keyword 

is_network_inf o_temporary). 

When automating system installations, the DHCP services allows 
systems to get networking information without the need to make a 
mapping in the H PUX-I nstall configuration files (See instl_adm(lm) 
and instl_adm(4)). 

• When a system boots for the first time (either after a Cold I nstall, or 
the first boot of a pre-loaded (I nstant Ignition) system): 
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NOTE 


The auto_parms tcxol, that lets you configure the system identity and 
basic configuration parameters, will invoke the dhcpciient, which 
will broadcast out to find a DHCP server. The server, in turn, provides 
a default set of networking parameters. 

I n both cold install and a first boot of a pre-loaded system, if the user 
chooses not to use the IP address given by the DHCP server, the tool 
will inform the DHCP server that it can release the lease on it and 
give it to someone else. 

• At each system boot: 

If a client system was initially set up using an IP address that was 
leased by a DHCP server, that client will check to ensure that the 
lease is still valid at each boot. I n addition, the system will start a 
daemon process (dhcpciient -m) that will maintain and renew that 
lease while the system is running. 

If a system cannot contact the DHCP server from which it originally 
got the IP address lease, it will try to contact other DHCP servers in 
order to determine if it has been moved to a different network. If this 
is the case, the system will write a message to the auto_parms log 
file (/etc/auto_parms. log) indicating that it has detected a move 
to a new subnet and that it is attempting to request a new lease. If 
the new lease request is successful, new networking configuration 
values supplied by the DHCP server will automatically be applied. 

If a system has been set up without using DHCP, but you would like to 

start using it, the foil owing steps may betaken. 


The system's hostname and IP address may change based on what the 
DHCP server assigns to it the first time it boots. 

There are two methods for enabling DHCP on a system that is not 
currently using it: 

1. The first method is to use SAM. 

a. As root, run sam. 

b. Doubleclick Networking and Communications. 

c. Doubleclick Network InterfaceCards. 

d. Highlight the card you wish to enable DHCP on, go to the Actions 
pull-down menu and select Configure. 
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e. Singleclick the Enable DHCP button. 


NOTE If EnableDHCP appears grayed-out, you will need to use the alternate 

method for enabling DHCP described below. 


f. Singleclick OK and exit SAM. 

Your system will now begin using DHCP after the next reboot. Please 
note that all of the current networking parameters will be overridden 
with new values supplied by the DHCP server. I f for some reason the 
system cannot contact a DH CP server duri ng the next reboot, it wi 11 
continuetouseitscurrent networking parameters. 

If you suspect that your system had problem contacting the DHCP 
server, you can examine the auto_parms log file 
(/etc/auto_parms. log) to determine if the lease request was 
successful. 

2. The second method for enabling DHCP over a particular network 
interface is use a text editor (such as vi or emacs) to edit the 
/etc/rc. config. d/netconf file. I n the header of this file, you will 
find some brief instructions regarding a variable named 
DHCP_ENABLE. This Variable is tied by an index number to an 
individual network interface. For example, in the following block: 

INTERFACE_NAME[0]=lanO 
IP_ADDRESS[0]=15.1.50.76 
SUBNET_MASK[0]=255.255.248.0 
BROADCAST_ADDRESS[0]="" 

DHCP_ENABLE[0]=1 

Here, the variables are instructing the system to use the lanO 
interface when attempting to contact a DHCP server. Similarly, if the 
lease request is successful, the above ip_address variable would be 
updated to reflect the new value supplied by the DHCP server. 

If the DHCP_ENABLE Variable was set to o or if the variable did not 
exist, no DHCP operations would be attempted over the 
corresponding network interface. 

As noted in the first method of enabling DHCP, if the variable 
DHCP_ENABLE does not exIst for a particular interface, the SAM tool 
will display a grayed out DHCP enable button. 

In this case, you will need to add the variable definition to a specific 
interface variable block. As an example, you would need to add 
DHCP_ENABLE [2] =1 tothefollowlng Interface Variable block in order 
to enable DHCP on theiani interface: 
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INTERFACE_NAME[2]=lanl 
IP_ADDRESS[2]=15.1.50.89 
SUBNET_MASK[2]=255.255.248.0 
BROADCAST_ADDRESS[2]="" 

The contents of /etc/rc. conf ig. d/netconf for this definition 
block should now look I ike the following: 

INTERFACE_NAME[2]=lanl 
IP_ADDRESS[2]=15.1.50.89 
SUBNET_MASK[2]=255.255.248.0 
BROADCAST_ADDRESS[2]="" 

DHCP_ENABLE[2]=1 

Correspondingly, you could disable DHCP over a particular interface 
by setting the variableto "0". 

Again, as in the first method, the system will only begin using DHCP 
after the next reboot. 

The DHCP protocol is implemented as extensions to the BOOTP 
protocol, and in fact the HP-UX DHCP server daemon and the BOOTP 
daemon are the same (bootpd(lM)). This daemon reads two configuration 
files: /etc/bootptab and /etc/dhcptab. 

The mapping of systems to IP addresses and lease time information is 
kept in the DHCP database file /etc/dhcpdb. Some amount of 
management of this database is provided by the dhcptooIsflM) 
command. 

On the client side, a command called /usr/ibin/dhcpciient is used 
to contact the server to get an IP address lease. This command has the 
ability to broadcast out onto the network prior to the network interface 
being enabled. 

The dhcpciient also serves as a daemon process that sleeps until the 
time that it needs to renew the IP address lease, at which time it will 
re-contact the server where it got the original lease in order to extend it. 

The dhcpciient command is not intended to be run by users directly, 
and is called by other tools during system bootup and installation. 
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For More Information Refer to the auto_parms(lM) man page and the dhcpdb2conf(lM) man 
page for more information regarding the networking parameters which 
DHCP can suppiy. 

More information on DHCP in generai can be found in thefoiiowing 
iocations: 

• Man pages: 

bootpd (Im) 
dhcptools(iM) 
auto_parms(iM) 
dhcpdb2conf (iM) 

• The Woridwide Web: 

http://web.syr.edu/~ jmwobus/comfaqs/dhcp.faq.html 
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